MCP Tools Reference

Tulsk exposes 21+ tools via the Model Context Protocol. These tools are available to EMA, external AI clients (Claude Desktop, Cursor), and any MCP-compatible application.

Projects

Project Tools

`get_projects`

List projects in the current organization.

Parameter	Type	Required	Description
`query`	string	No	Search by name/description
`limit`	number	No	Max results (default: 20)
`memberOnly`	boolean	No	Only projects user is a member of

`get_project_by_id`

Get detailed project information including recent tasks.

Parameter	Type	Required	Description
`projectId`	string	Yes	Project UUID

`create_project`

Create a new project.

Parameter	Type	Required	Description
`name`	string	Yes	Project name
`description`	string	No	Project description
`emoji`	string	No	Project emoji

Tasks

Task Tools

`get_task_context`

Get full task details including comments and assignees.

Parameter	Type	Required	Description
`taskId`	string	Yes	Task UUID

`create_task`

Create a new task in a project.

Parameter	Type	Required	Description
`title`	string	Yes	Task title
`projectId`	string	Yes	Project UUID
`content`	string	No	Task description
`status`	string	No	`To_Do`, `In_Progress`, etc.
`priority`	string	No	`Low`, `Medium`, `High`, `Urgent`

`update_task`

Update an existing task.

Parameter	Type	Required	Description
`taskId`	string	Yes	Task UUID
`title`	string	No	New title
`status`	string	No	New status
`priority`	string	No	New priority
`assigneeIds`	string[]	No	Assignee user IDs

`add_comment`

Agents

Agent Tools

`list_agents`

List all agents with name, role, skills, status, and run count.

`get_agent_detail`

Get full agent details: persona, skills, tools, run history, and budget.

Parameter	Type	Required	Description
`agentId`	string	Yes	Agent UUID

`trigger_agent_run`

Queue an agent to work on a task.

Parameter	Type	Required	Description
`agentId`	string	Yes	Agent UUID
`taskId`	string	Yes	Task UUID or task number
`executionNote`	string	No	Instructions for the agent
`chatId`	string	No	EMA chat ID for result push-back

EMA PM

EMA PM Tools

`get_agent_activity_summary`

Comprehensive activity summary grouped by agent and project.

Parameter	Type	Required	Description
`timeRange`	string	No	”24h”, “7d”, or “30d”
`agentId`	string	No	Filter by agent
`projectId`	string	No	Filter by project

`get_delegation_tree`

Trace the delegation chain for an agent run.

Parameter	Type	Required	Description
`runId`	string	Yes	AgentRun UUID

Schedules

Schedule Tools

`create_ema_schedule`

Create a recurring EMA report schedule.

Parameter	Type	Required	Description
`cronExpression`	string	Yes	Cron expression (5 fields)
`description`	string	Yes	Human-readable description
`promptTemplate`	string	Yes	What EMA should report on
`timezone`	string	No	Timezone (default: UTC)

`list_ema_schedules`

List all active report schedules.

`cancel_ema_schedule`

Deactivate a schedule.

Parameter	Type	Required	Description
`scheduleId`	string	Yes	Schedule UUID

All Tool UUIDs are standard V4 UUIDs. You can find them in the URL of the corresponding entity in the Tulsk UI.