API_REFERENCE_V1

MCP Tools Reference

Complete specification for the 13 available MCP tools.

Always pass projectId from sharpsana.config.json field projectId. Do not pass projectName.

Project Context

Core context and cross-source project Q&A tools.

get_project_context

Get project vision, details, audience, and tech stack context.

get_project_context(projectId: string)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

Prompt Example

"Use sharpsana to get the project context for this repo."

ask_projectRAG

Ask one question across codebase, materials, insights, interviews, tasks, and roadmap.

ask_project(projectId: string, query: string, limit?: number)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryREQ(string)- Question or search query

limitOPT(number)- Max results per source (default 3, max 8)

Prompt Example

"Ask sharpsana: what are the highest-impact issues from interviews and code?"

Sprints & Tasks

Tools for sprint visibility, task search, and task actions.

get_current_sprint

Get active sprint info and progress summary.

get_current_sprint(projectId: string)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

Prompt Example

"What is the current sprint goal and progress?"

get_sprint_tasks

Get all tasks in a sprint (defaults to current sprint).

get_sprint_tasks(projectId: string, sprintId?: string, status?: string)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

sprintIdOPT(string)- Optional sprint ID

statusOPT(string)- Optional status filter

limitOPT(number)- Max tasks (default 200, max 1000)

Prompt Example

"List all in-progress tasks in the current sprint."

search_tasks

Search tasks by text with optional status/priority/sprint filters.

search_tasks(projectId: string, query?: string, ...filters)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryOPT(string)- Task search query

taskIdOPT(string)- Exact task lookup by ID

statusOPT(string)- Status filter

priorityOPT(string)- Priority filter

sprintIdOPT(string)- Sprint filter

limitOPT(number)- Max results (default 20, max 100)

Prompt Example

"Find all high-priority auth tasks in sprint S1."

manage_taskWrite

Create tasks, delete tasks, or update task status.

manage_task(projectId: string, action: create|delete|update_status, ...)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

actionREQ(enum)- create | delete | update_status

taskIdOPT(string)- Required for delete/update_status

statusOPT(string)- Required for update_status

titleOPT(string)- Required for create

descriptionOPT(string)- Optional create field

priorityOPT(string)- Optional create field

estimatedHoursOPT(number)- Optional create field

sprintIdOPT(string)- Optional create field

Prompt Example

"Set task t-123 status to done."

search_roadmap_items

Search/list roadmap items by query, status, and date period (including next 2 weeks).

search_roadmap_items(projectId: string, query?: string, period?: string, startDate?: string, endDate?: string, ...)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

roadmapItemIdOPT(string)- Exact roadmap item lookup by ID

queryOPT(string)- Roadmap search query

statusOPT(string)- planned | in-progress | done | blocked

periodOPT(string)- next_2_weeks, next_14_days, current_month, etc.

startDateOPT(string)- Window start (YYYY-MM-DD)

endDateOPT(string)- Window end (YYYY-MM-DD)

limitOPT(number)- Max results (default 30, max 200)

Prompt Example

"List roadmap items planned for the next 2 weeks."

manage_roadmap_itemWrite

Create, edit/update, or delete roadmap timeline items.

manage_roadmap_item(projectId: string, action: create|update|delete, ...)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

actionREQ(enum)- create | update | delete (edit/remove aliases allowed)

roadmapItemIdOPT(string)- Required for update/delete

titleOPT(string)- Required for create; optional for update

descriptionOPT(string)- Optional roadmap description

statusOPT(string)- planned | in-progress | done | blocked

startDateOPT(string)- Required for create (YYYY-MM-DD)

endDateOPT(string)- Required for create (YYYY-MM-DD)

colorOPT(string)- Optional color hex

Prompt Example

"Move roadmap item rm-42 to next month and mark in-progress."

Insights

Insight retrieval and creation tools.

search_insights

Search insight cards, including text and suggested tasks.

search_insights(projectId: string, query?: string, insightId?: string, ...)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryOPT(string)- Search query

insightIdOPT(string)- Exact insight lookup by ID

statusOPT(string)- Optional status filter

limitOPT(number)- Max results (default 10, max 50)

Prompt Example

"Search insights about onboarding drop-off and show linked tasks."

create_insightWrite

Create a new insight card from coding or product discovery.

create_insight(projectId, title, description, ...)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

titleREQ(string)- Insight title

descriptionREQ(string)- Insight description

categoryOPT(enum)- feature | improvement | ux | technical | business

priorityOPT(enum)- low | medium | high

effortOPT(enum)- small | medium | large

Prompt Example

"Create an insight: simplify onboarding setup with guided defaults."

Search Sources

Source-specific tools for codebase, materials, and interviews.

search_codebaseRAG

Search only in connected GitHub repository code.

search_codebase(projectId, query, limit?)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryREQ(string)- Code search query

limitOPT(number)- Max results (default 5, max 20)

Prompt Example

"Search where JWT tokens are validated."

search_materialsRAG

Search only in indexed materials (documents and links).

search_materials(projectId, query, limit?)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryREQ(string)- Materials search query

limitOPT(number)- Max results (default 5, max 20)

Prompt Example

"Find PRD notes related to billing permissions."

search_interviews

Search only in interview transcripts and interview analysis content.

search_interviews(projectId, query?, interviewId?, limit?)

Parameters

projectIdREQ(string)- Read from sharpsana.config.json field projectId (NOT projectName)

queryOPT(string)- Interview search query

interviewIdOPT(string)- Exact interview lookup by ID

limitOPT(number)- Max results (default 8, max 30)

Prompt Example

"Find interviews that mention pricing friction."