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.

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

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	Status (default: To_Do)
priority	string	No	Priority (default: Medium)

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

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, budget, instance health.

Parameter	Type	Required	Description
agentId	string	Yes	Agent UUID

get_agent_runs

List recent agent runs.

Parameter	Type	Required	Description
agentId	string	No	Filter by agent
taskId	string	No	Filter by task
status	string	No	Filter by status

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

get_run_result

Check status and output of a specific run.

Parameter	Type	Required	Description
runId	string	Yes	AgentRun UUID

cancel_agent_run

Cancel a pending or running agent run.

Parameter	Type	Required	Description
runId	string	Yes	AgentRun UUID

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” (default: “7d”)
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

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)
projectId	string	No	Scope to a project
chatId	string	No	Deliver to this chat

list_ema_schedules

List all EMA scheduled reports for the organization.

cancel_ema_schedule

Deactivate a schedule.

Parameter	Type	Required	Description
scheduleId	string	Yes	Schedule UUID