Intelligent context infrastructure for AI teams: knowledge graph, sessions, tasks, documents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer JWT issued by ContextLayer (sign in at https://app.dotnova.io and copy the API token from Settings -> API Keys). Format: 'Bearer <token>'.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accept a pending organization invite by organization name.
Organization name to accept the invite for
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Accept a pending organization invite by organization name.
| Argument | Type | Description |
|---|---|---|
| org_name* | string | Organization name to accept the invite for |
{
"type": "object",
"title": "AcceptOrgInviteParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"org_name"
],
"properties": {
"org_name": {
"type": "string",
"description": "Organization name to accept the invite for"
}
}
}Add a dependency between tasks. Use this to express that a task is blocked by another task (must complete first) or relates to it. This prevents context contamination: when Task B depends on Task A, agents working on Task B will be warned if Task A is still in progress.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | The task that is blocked (depends on the other task) |
| dependency_type | string | null | Dependency type: 'blocks' (must complete before) or 'relates_to' (informational link). Default: blocks |
| depends_on_task_id* | string | The task that blocks (the dependency / prerequisite) |
{
"type": "object",
"title": "AddTaskDependencyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"depends_on_task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task that is blocked (depends on the other task)"
},
"dependency_type": {
"type": [
"string",
"null"
],
"description": "Dependency type: 'blocks' (must complete before) or 'relates_to' (informational link). Default: blocks"
},
"depends_on_task_id": {
"type": "string",
"description": "The task that blocks (the dependency / prerequisite)"
}
}
}Add a member to a team. Find the team by name or ID, and the user by name or email.
| Argument | Type | Description |
|---|---|---|
| role | string | null | Role in team: member or lead (default: member) |
| user* | string | User name or email to add |
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
{
"type": "object",
"title": "AddTeamMemberParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user"
],
"properties": {
"role": {
"type": [
"string",
"null"
],
"description": "Role in team: member or lead (default: member)"
},
"user": {
"type": "string",
"description": "User name or email to add"
},
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
}
}
}Assign a user to a task by name or email. The user is added to the task's assignees and linked in the knowledge graph.
| Argument | Type | Description |
|---|---|---|
| user* | string | User name or email to assign |
| task_id* | string | Task ID |
{
"type": "object",
"title": "AssignTaskParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"user"
],
"properties": {
"user": {
"type": "string",
"description": "User name or email to assign"
},
"task_id": {
"type": "string",
"description": "Task ID"
}
}
}Create a new job position/title in your organization (admin only).
| Argument | Type | Description |
|---|---|---|
| title* | string | Position title (e.g. 'Frontend Developer') |
| description | string | null | Position description (optional) |
| permissions | any | JSON object mapping permission keys to booleans, e.g. {"can_view_all_projects": true, "can_manage_documents": false}. Use list_positions to see all available permission keys. |
{
"type": "object",
"title": "CreatePositionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"description": "Position title (e.g. 'Frontend Developer')"
},
"description": {
"type": [
"string",
"null"
],
"description": "Position description (optional)"
},
"permissions": {
"description": "JSON object mapping permission keys to booleans, e.g. {\"can_view_all_projects\": true, \"can_manage_documents\": false}. Use list_positions to see all available permission keys."
}
}
}Create a new project in your organization. You will be added as the project owner.
| Argument | Type | Description |
|---|---|---|
| name* | string | Project name |
| description | string | null | Project description (optional) |
{
"type": "object",
"title": "CreateProjectParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Project name"
},
"description": {
"type": [
"string",
"null"
],
"description": "Project description (optional)"
}
}
}Create a new sprint for a project. Automatically migrates non-completed tasks (todo/in_progress) from the previous sprint. On first use, creates Sprint 0 (Backlog) for existing tasks and Sprint 1 as the active sprint.
| Argument | Type | Description |
|---|---|---|
| goal | string | null | Sprint goal (optional) |
| name | string | null | Sprint name (default: 'Sprint N') |
| project_id | string | null | Project ID (alternative to project_name) |
| project_name | string | null | Project name |
{
"type": "object",
"title": "CreateSprintParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"goal": {
"type": [
"string",
"null"
],
"description": "Sprint goal (optional)"
},
"name": {
"type": [
"string",
"null"
],
"description": "Sprint name (default: 'Sprint N')"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (alternative to project_name)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name"
}
}
}Create a new task in a project. Tasks track work items and can be assigned to team members and linked to sessions.
| Argument | Type | Description |
|---|---|---|
| tags | array | null | Tags for categorization (e.g. ['bug', 'frontend']) |
| title* | string | Task title |
| due_at | string | null | Due date in ISO 8601 format (e.g. '2026-03-15T00:00:00Z') |
| team_id | string | null | Team ID (alternative to team_name) |
| priority | string | null | Priority: low, medium, high, urgent (default: medium) |
| assignees | array | null | Assignee names or emails (optional — resolves to user IDs) |
| team_name | string | null | Team name to assign to (optional — resolves to team ID) |
| depends_on | array | null | Task IDs that this task depends on / is blocked by (optional). Creates 'blocks' dependencies. |
| project_id | string | null | Project ID (alternative to project_name) |
Create a new team in your organization. You will be added as team lead.
| Argument | Type | Description |
|---|---|---|
| name* | string | Team name |
| objectives | array | null | Team objectives as a list of strings (optional) |
| description | string | null | Team description (optional) |
{
"type": "object",
"title": "CreateTeamParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Team name"
},
"objectives": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Team objectives as a list of strings (optional)"
},
"description": {
"type": [
"string",
"null"
],
"description": "Team description (optional)"
}
}
}Delete a document from the knowledge base. This permanently removes the document.
| Argument | Type | Description |
|---|---|---|
| document_id* | string | Document ID to delete |
{
"type": "object",
"title": "DeleteDocumentParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"description": "Document ID to delete"
}
}
}Delete a position permanently (admin only). Find by title or ID.
| Argument | Type | Description |
|---|---|---|
| position_id | string | null | Position ID (optional if position_title is provided) |
| position_title | string | null | Position title (optional if position_id is provided) |
{
"type": "object",
"title": "DeletePositionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"position_id": {
"type": [
"string",
"null"
],
"description": "Position ID (optional if position_title is provided)"
},
"position_title": {
"type": [
"string",
"null"
],
"description": "Position title (optional if position_id is provided)"
}
}
}Delete a project permanently (admin only). Find by name or ID.
| Argument | Type | Description |
|---|---|---|
| project_id | string | null | Project ID (optional if project_name is provided) |
| project_name | string | null | Project name (optional if project_id is provided) |
{
"type": "object",
"title": "DeleteProjectParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional if project_id is provided)"
}
}
}Delete a task permanently. The task and all its assignee links are removed.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task ID to delete |
{
"type": "object",
"title": "DeleteTaskParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task ID to delete"
}
}
}Delete a team permanently (admin only). Find by name or ID.
| Argument | Type | Description |
|---|---|---|
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
{
"type": "object",
"title": "DeleteTeamParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
}
}
}Delete (soft-delete) a user from your organization (admin/owner only).
| Argument | Type | Description |
|---|---|---|
| user* | string | User name or email to delete |
{
"type": "object",
"title": "DeleteUserParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"description": "User name or email to delete"
}
}
}End a work session. This triggers context block generation — your activities are summarized and stored in the knowledge graph for future reference.
| Argument | Type | Description |
|---|---|---|
| outcome* | string | Outcome: success, failure, partial, abandoned |
| session_id* | string | Session ID to end |
| token_usage | any | Token usage for this session. JSON object with fields: input_tokens (int), output_tokens (int), total_tokens (int), model (string), estimated_cost_usd (float). Optional — set when the agent can report consumption. |
{
"type": "object",
"title": "EndSessionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"session_id",
"outcome"
],
"properties": {
"outcome": {
"type": "string",
"description": "Outcome: success, failure, partial, abandoned"
},
"session_id": {
"type": "string",
"description": "Session ID to end"
},
"token_usage": {
"description": "Token usage for this session. JSON object with fields: input_tokens (int), output_tokens (int), total_tokens (int), model (string), estimated_cost_usd (float). Optional — set when the agent can report consumption."
}
}
}Search documents in the organization's knowledge base. Filter by category, tags, project, or free-text query. Returns document metadata — use get_document to read the full content.
| Argument | Type | Description |
|---|---|---|
| tags | array | null | Filter by tags |
| limit | integer | null | Maximum results (default 10) |
| query | string | null | Search query (matches title and content) |
| category | string | null | Filter by category: template, policy, procedure, reference, contract, guide, checklist |
| team_name | string | null | Filter by team name |
| project_name | string | null | Filter by project name |
{
"type": "object",
"title": "FindDocumentsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Filter by tags"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 10)"
},
"query": {
"type": [
"string",
"null"
],
"description": "Search query (matches title and content)"
},
"category": {
"type": [
"string",
"null"
],
"description": "Filter by category: template, policy, procedure, reference, contract, guide, checklist"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Filter by team name"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Filter by project name"
}
}
}Get intelligent context from the knowledge graph. Pass a query describing what you need — the system will automatically route to the right data sources (tasks, sessions, documents, teams, blocks) based on intent analysis + graph traversal + semantic similarity. Optionally narrow scope with project name or session ID.
| Argument | Type | Description |
|---|---|---|
| query* | string | The user's question or intent — used for intelligent context routing. Describe what context is needed. |
| max_tokens | integer | null | Maximum tokens for the response (default 500) |
| project_id | string | null | Project ID (optional — if omitted, returns across all projects) |
| session_id | string | null | Session ID (optional — if omitted, returns user-level context) |
| project_name | string | null | Project name (optional, alternative to project_id) |
{
"type": "object",
"title": "GetContextParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The user's question or intent — used for intelligent context routing. Describe what context is needed."
},
"max_tokens": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum tokens for the response (default 500)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional — if omitted, returns across all projects)"
},
"session_id": {
"type": [
"string",
"null"
],
"description": "Session ID (optional — if omitted, returns user-level context)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, alternative to project_id)"
}
}
}Get the current context routing mode for the organization. Returns 'keyword_llm', 'keyword_only', or 'llm_only'.
No arguments.
{
"type": "object",
"title": "GetContextRoutingParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Get the full content of a document by its ID. Use find_documents first to search, then get_document to read the content. For binary documents (PDFs, images), content is returned base64-encoded with encoding='base64' and the mime_type field.
| Argument | Type | Description |
|---|---|---|
| document_id* | string | Document ID |
{
"type": "object",
"title": "GetDocumentParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"description": "Document ID"
}
}
}See what's happening right now: active sessions, recent events, traces, and tasks being worked on.
| Argument | Type | Description |
|---|---|---|
| team_name | string | null | Filter by team name (optional) |
| user_name | string | null | Filter by user name (optional, partial match) |
| project_name | string | null | Filter by project name (optional) |
| recent_minutes | integer | null | Time window for recent events in minutes (default: 30) |
{
"type": "object",
"title": "GetLiveActivityParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_name": {
"type": [
"string",
"null"
],
"description": "Filter by team name (optional)"
},
"user_name": {
"type": [
"string",
"null"
],
"description": "Filter by user name (optional, partial match)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Filter by project name (optional)"
},
"recent_minutes": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Time window for recent events in minutes (default: 30)"
}
}
}Get your personal activity statistics: total sessions, events, active days, projects worked on, and recent activity summary.
No arguments.
{
"type": "object",
"title": "EmptyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Get comprehensive organization statistics: counts, engagement metrics, task velocity.
No arguments.
{
"type": "object",
"title": "GetOrgStatsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Get the current status of a project including recent activity. You can use either the project name or ID.
| Argument | Type | Description |
|---|---|---|
| project_id | string | null | Project ID (optional if project_name is provided) |
| project_name | string | null | Project name (optional, alternative to project_id) |
{
"type": "object",
"title": "GetProjectStatusParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, alternative to project_id)"
}
}
}Get full details of a session including all events/activities logged during it. Shows who did what, when, and the session block summary if available. Admins can view any session in the org; members can only view their own.
| Argument | Type | Description |
|---|---|---|
| session_id* | string | Session ID to get details for |
{
"type": "object",
"title": "GetSessionDetailsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"session_id"
],
"properties": {
"session_id": {
"type": "string",
"description": "Session ID to get details for"
}
}
}Get detailed information about a team: members (with roles), linked projects, and recent activity. Use team name or ID.
| Argument | Type | Description |
|---|---|---|
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
{
"type": "object",
"title": "GetTeamDetailsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
}
}
}Invite a new member to your organization (admin/owner only).
| Argument | Type | Description |
|---|---|---|
| name* | string | Full name |
| role | string | null | Role: member or admin (default: member) |
| email* | string | User email address |
| skills | array | null | Skills list (optional) |
| positions | array | null | Position titles to assign (optional — resolves by name) |
| team_name | string | null | Team name to add user to (optional) |
{
"type": "object",
"title": "InviteUserParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Full name"
},
"role": {
"type": [
"string",
"null"
],
"description": "Role: member or admin (default: member)"
},
"email": {
"type": "string",
"description": "User email address"
},
"skills": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Skills list (optional)"
},
"positions": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Position titles to assign (optional — resolves by name)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name to add user to (optional)"
}
}
}Link a work session to a task. This records that the session was used to work on the task, connecting them in the knowledge graph.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task ID to link |
| session_id* | string | Session ID to link to the task |
{
"type": "object",
"title": "LinkTaskSessionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"session_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task ID to link"
},
"session_id": {
"type": "string",
"description": "Session ID to link to the task"
}
}
}Link a project to a team. Find both by name or ID.
| Argument | Type | Description |
|---|---|---|
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
| project_id | string | null | Project ID (optional if project_name is provided) |
| project_name | string | null | Project name (optional if project_id is provided) |
{
"type": "object",
"title": "LinkTeamProjectParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional if project_id is provided)"
}
}
}List colleagues in your organization. Shows name, email, role, and optionally filters by team. Admins see all users; members see users in their own teams.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum results (default 20) |
| team_name | string | null | Filter by team name (optional — shows only members of that team) |
{
"type": "object",
"title": "ListColleaguesParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 20)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Filter by team name (optional — shows only members of that team)"
}
}
}List your notifications — task assignments, status changes, sprint updates, invites, and more. Returns unread notifications by default.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum results (default 20) |
| unread_only | boolean | null | Only return unread notifications (default: true) |
{
"type": "object",
"title": "ListNotificationsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 20)"
},
"unread_only": {
"type": [
"boolean",
"null"
],
"description": "Only return unread notifications (default: true)"
}
}
}List pending organization invites for the current user.
No arguments.
{
"type": "object",
"title": "ListPendingInvitesParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}List all job positions/titles in your organization with member counts.
No arguments.
{
"type": "object",
"title": "ListPositionsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}List all members involved in a project. Includes users who have sessions in the project and users from teams linked to the project.
| Argument | Type | Description |
|---|---|---|
| project_id | string | null | Project ID |
| project_name | string | null | Project name (alternative to project_id) |
{
"type": "object",
"title": "ListProjectMembersParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (alternative to project_id)"
}
}
}List teams linked to a project.
| Argument | Type | Description |
|---|---|---|
| project_id | string | null | Project ID |
| project_name | string | null | Project name (alternative to project_id) |
{
"type": "object",
"title": "ListProjectTeamsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (alternative to project_id)"
}
}
}List projects in your organization. No parameters needed — just call it to see all your projects.
| Argument | Type | Description |
|---|---|---|
| org_id | string | null | Optional organization ID (uses default org if omitted) |
{
"type": "object",
"title": "ListProjectsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"org_id": {
"type": [
"string",
"null"
],
"description": "Optional organization ID (uses default org if omitted)"
}
}
}List your recent work sessions. Optionally filter by project name or ID. Shows task type, status, and event count.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum results (default 10) |
| project_id | string | null | Filter by project ID (optional) |
| project_name | string | null | Filter by project name (optional, alternative to project_id) |
{
"type": "object",
"title": "ListSessionsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 10)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Filter by project ID (optional)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Filter by project name (optional, alternative to project_id)"
}
}
}List sprints for a project. Shows sprint number, name, goal, status (current/completed), and task count.
| Argument | Type | Description |
|---|---|---|
| project_id | string | null | Project ID (alternative to project_name) |
| project_name | string | null | Project name |
{
"type": "object",
"title": "ListSprintsParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (alternative to project_name)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name"
}
}
}List tasks. Filter by project, status (todo/in_progress/done/cancelled), sprint number, or show only your tasks. Shows title, status, priority, assignees, sprint, and linked sessions.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum results (default 20) |
| status | string | null | Filter by status: todo, in_progress, done, cancelled (optional) |
| mine_only | boolean | null | Filter tasks assigned to me only (default: false) |
| project_name | string | null | Filter by project name (optional) |
| sprint_number | integer | null | Filter by sprint number (optional) |
{
"type": "object",
"title": "ListTasksParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 20)"
},
"status": {
"type": [
"string",
"null"
],
"description": "Filter by status: todo, in_progress, done, cancelled (optional)"
},
"mine_only": {
"type": [
"boolean",
"null"
],
"description": "Filter tasks assigned to me only (default: false)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Filter by project name (optional)"
},
"sprint_number": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Filter by sprint number (optional)"
}
}
}List all teams in your organization. Shows team name, member count, project count, and description.
No arguments.
{
"type": "object",
"title": "EmptyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Log an activity or event. If no session_id is provided, a session is automatically created or reused for the project. Just pass project_name and content — no need to start a session first.
| Argument | Type | Description |
|---|---|---|
| source | string | null | Source of the event (e.g. 'claude-code', 'cursor', 'user') |
| content* | string | Free-form content describing the activity |
| event_type* | string | Event type: code_change, file_edit, command_run, decision, note, conversation, discovery |
| project_id | string | null | Project ID (optional if project_name is provided) |
| session_id | string | null | Session ID (optional — if omitted, a session is auto-created or reused for the project) |
| project_name | string | null | Project name (optional, alternative to project_id — used for auto-session) |
{
"type": "object",
"title": "LogActivityParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_type",
"content"
],
"properties": {
"source": {
"type": [
"string",
"null"
],
"description": "Source of the event (e.g. 'claude-code', 'cursor', 'user')"
},
"content": {
"type": "string",
"description": "Free-form content describing the activity"
},
"event_type": {
"type": "string",
"description": "Event type: code_change, file_edit, command_run, decision, note, conversation, discovery"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"session_id": {
"type": [
"string",
"null"
],
"description": "Session ID (optional — if omitted, a session is auto-created or reused for the project)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, alternative to project_id — used for auto-session)"
}
}
}Log a granular agent action trace. High-frequency, no LLM processing.
| Argument | Type | Description |
|---|---|---|
| status | string | null | Status: started, completed, failed (default: completed) |
| summary* | string | Short description of the action |
| task_id | string | null | Task ID to link this trace to (optional — auto-links session to task) |
| metadata | any | Free-form JSON metadata (optional) |
| trace_id | string | null | Logical trace group ID (auto-generated if omitted) |
| project_id | string | null | Project ID (optional, alternative to project_name) |
| session_id | string | null | Session ID (optional — auto-resolved from project if omitted) |
| trace_type* | string | Trace type: tool_call, file_read, file_write, code_search, code_edit, api_call, thinking, error |
| duration_ms | integer | null | Duration in milliseconds (optional) |
Log multiple traces in a single batch.
| Argument | Type | Description |
|---|---|---|
| traces* | array | Array of traces to log in a single batch |
{
"type": "object",
"$defs": {
"LogTraceParams": {
"type": "object",
"required": [
"trace_type",
"summary"
],
"properties": {
"status": {
"type": [
"string",
"null"
],
"description": "Status: started, completed, failed (default: completed)"
},
"summary": {
"type": "string",
"description": "Short description of the action"
},
"task_id": {
"type": [
"string",
"null"
],
"description": "Task ID to link this trace to (optional — auto-links session to task)"
},
"metadata": {
"description": "Free-form JSON metadata (optional)"
},
"trace_id": {
"type": [
"string",
"null"
],
"description": "Logical trace group ID (auto-generated if omitted)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional, alternative to project_name)"
},
"session_id": {
"type": [
"string",
"null"
],
"description": "Session ID (optional — auto-resolved from project if omitted)"
},
"trace_type": {
"type": "string",
"description": "Trace type: tool_call, file_read, file_write, code_search, code_edit, api_call, thinking, error"
},
"duration_ms": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Duration in milliseconds (optional)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, used for auto-session resolution)"
},
"parent_trace_id": {
"type": [
"string",
"null"
],
"description": "Parent trace ID for nesting (e.g. tool_call -> file_reads)"
}
}
}
},
"title": "LogTracesBatchParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"traces"
],
"properties": {
"traces": {
"type": "array",
"items": {
"$ref": "#/$defs/LogTraceParams"
},
"description": "Array of traces to log in a single batch"
}
}
}Mark a notification as read, or mark all notifications as read at once.
| Argument | Type | Description |
|---|---|---|
| mark_all | boolean | null | Set to true to mark ALL notifications as read |
| notification_id | string | null | Notification ID to mark as read (omit to use mark_all) |
{
"type": "object",
"title": "MarkNotificationReadParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"mark_all": {
"type": [
"boolean",
"null"
],
"description": "Set to true to mark ALL notifications as read"
},
"notification_id": {
"type": [
"string",
"null"
],
"description": "Notification ID to mark as read (omit to use mark_all)"
}
}
}Move a task to a different sprint. Specify the target sprint by number or ID.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task ID to move |
| sprint_id | string | null | Target sprint ID (alternative to sprint_number) |
| project_name | string | null | Project name (needed if using sprint_number) |
| sprint_number | integer | null | Target sprint number |
{
"type": "object",
"title": "MoveTaskToSprintParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task ID to move"
},
"sprint_id": {
"type": [
"string",
"null"
],
"description": "Target sprint ID (alternative to sprint_number)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (needed if using sprint_number)"
},
"sprint_number": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Target sprint number"
}
}
}Remove a dependency between tasks. This unblocks the task from the other task.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | The task that was blocked |
| depends_on_task_id* | string | The task that was blocking it |
{
"type": "object",
"title": "RemoveTaskDependencyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"depends_on_task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "The task that was blocked"
},
"depends_on_task_id": {
"type": "string",
"description": "The task that was blocking it"
}
}
}Remove a member from a team. Find the team by name or ID, and the user by name or email.
| Argument | Type | Description |
|---|---|---|
| user* | string | User name or email to remove |
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
{
"type": "object",
"title": "RemoveTeamMemberParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"description": "User name or email to remove"
},
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
}
}
}Remove a user from the current organization without deleting their account. Admin/owner only.
| Argument | Type | Description |
|---|---|---|
| user* | string | User name or email to remove from the organization |
{
"type": "object",
"title": "RemoveUserFromOrgParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"description": "User name or email to remove from the organization"
}
}
}Search entities in the knowledge graph by name. Finds people, companies, documents, concepts, tools, etc. that have been mentioned in your activities.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum results (default 10) |
| query* | string | Search query string (matches entity names) |
| entity_type | string | null | Entity type filter: person, company, document, concept, tool, template, process |
{
"type": "object",
"title": "SearchEntitiesParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Maximum results (default 10)"
},
"query": {
"type": "string",
"description": "Search query string (matches entity names)"
},
"entity_type": {
"type": [
"string",
"null"
],
"description": "Entity type filter: person, company, document, concept, tool, template, process"
}
}
}Set the context routing mode for the organization. Requires admin role. Options: 'keyword_llm' (balanced), 'keyword_only' (fastest), 'llm_only' (most accurate).
| Argument | Type | Description |
|---|---|---|
| mode* | string | Routing mode: 'keyword_llm' (keyword + LLM fallback), 'keyword_only' (fastest), or 'llm_only' (most accurate) |
{
"type": "object",
"title": "SetContextRoutingParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"description": "Routing mode: 'keyword_llm' (keyword + LLM fallback), 'keyword_only' (fastest), or 'llm_only' (most accurate)"
}
}
}Set up your organization in one step (admin only). Use this for onboarding.
| Argument | Type | Description |
|---|---|---|
| links | array | null | Links: [{"label": "...", "url": "...", "type": "website|repository|documentation|slack|jira|notion|figma|other"}] |
| teams | array | null | Teams to create: [{"name": "...", "description": "..."}] |
| projects | array | null | Projects to create: [{"name": "...", "description": "..."}] |
| objectives* | array | Organization objectives |
| description* | string | Organization description |
| business_model* | string | Business model description |
| custom_context | string | null | Custom context for AI agents (optional) |
{
"type": "object",
"$defs": {
"SetupLink": {
"type": "object",
"required": [
"label",
"url",
"type"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string",
"description": "Link type: website, repository, documentation, slack, jira, notion, figma, other"
},
"label": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
}
}
},
"SetupTeam": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
},
"SetupProject": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
},
"title": "SetupOrganizationParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"description",
"business_model",
"objectives"
],
"properties": {
"links": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/$defs/SetupLink"
},
"description": "Links: [{\"label\": \"...\", \"url\": \"...\", \"type\": \"website|repository|documentation|slack|jira|notion|figma|other\"}]"
},
"teams": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/$defs/SetupTeam"
},
"description": "Teams to create: [{\"name\": \"...\", \"description\": \"...\"}]"
},
"projects": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/$defs/SetupProject"
},
"description": "Projects to create: [{\"name\": \"...\", \"description\": \"...\"}]"
},
"objectives": {
"type": "array",
"items": {
"type": "string"
},
"description": "Organization objectives"
},
"description": {
"type": "string",
"description": "Organization description"
},
"business_model": {
"type": "string",
"description": "Business model description"
},
"custom_context": {
"type": [
"string",
"null"
],
"description": "Custom context for AI agents (optional)"
}
}
}Start a work session. If a project is provided (project_name or project_id), the session is bound to it; if neither is provided, an unbound (projectless) session is created — useful when the work isn't tied to a specific project. Reuses an existing active session for the same scope (per-project, or one global projectless session per user). Task type: coding, review, planning, debugging, research, meeting, other.
| Argument | Type | Description |
|---|---|---|
| source | string | null | Source client identifier (e.g. 'claude-code', 'claude-web', 'chatgpt', 'cursor'). Helps track which tool created the session. |
| task_type* | string | Type of task: coding, review, planning, debugging, research, meeting, other |
| project_id | string | null | Project ID to start the session in (optional if project_name provided) |
| project_name | string | null | Project name (optional, alternative to project_id) |
{
"type": "object",
"title": "StartSessionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_type"
],
"properties": {
"source": {
"type": [
"string",
"null"
],
"description": "Source client identifier (e.g. 'claude-code', 'claude-web', 'chatgpt', 'cursor'). Helps track which tool created the session."
},
"task_type": {
"type": "string",
"description": "Type of task: coding, review, planning, debugging, research, meeting, other"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID to start the session in (optional if project_name provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, alternative to project_id)"
}
}
}Remove a user from a task's assignees.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task ID |
| user_id* | string | User ID to remove from assignees |
{
"type": "object",
"title": "UnassignTaskParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"user_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"user_id": {
"type": "string",
"description": "User ID to remove from assignees"
}
}
}Unlink a project from a team. Find both by name or ID.
| Argument | Type | Description |
|---|---|---|
| team_id | string | null | Team ID (optional if team_name is provided) |
| team_name | string | null | Team name (optional if team_id is provided) |
| project_id | string | null | Project ID (optional if project_name is provided) |
| project_name | string | null | Project name (optional if project_id is provided) |
{
"type": "object",
"title": "LinkTeamProjectParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name (optional if team_id is provided)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional if project_id is provided)"
}
}
}Update your organization's details (owner only). Set name, description, business model, objectives, custom context for AI, or links.
| Argument | Type | Description |
|---|---|---|
| name | string | null | Organization name (optional) |
| links | any | Links as JSON array: [{"label": "...", "url": "...", "type": "..."}] (optional) |
| objectives | array | null | Objectives as a list of strings (optional) |
| description | string | null | Organization description (optional) |
| business_model | string | null | Business model description (optional) |
| custom_context | string | null | Custom context for AI agents (optional) |
{
"type": "object",
"title": "UpdateOrgParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Organization name (optional)"
},
"links": {
"description": "Links as JSON array: [{\"label\": \"...\", \"url\": \"...\", \"type\": \"...\"}] (optional)"
},
"objectives": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Objectives as a list of strings (optional)"
},
"description": {
"type": [
"string",
"null"
],
"description": "Organization description (optional)"
},
"business_model": {
"type": [
"string",
"null"
],
"description": "Business model description (optional)"
},
"custom_context": {
"type": [
"string",
"null"
],
"description": "Custom context for AI agents (optional)"
}
}
}Update a position's title, description, or permissions (admin only). Find by title or ID.
| Argument | Type | Description |
|---|---|---|
| new_title | string | null | New title (optional) |
| position_id | string | null | Position ID (optional if position_title is provided) |
| position_title | string | null | Position title to find (optional if position_id is provided) |
| new_description | string | null | New description (optional) |
| new_permissions | any | New permissions JSON object mapping permission keys to booleans, e.g. {"can_view_all_projects": true}. Use list_positions to see all available keys. |
{
"type": "object",
"title": "UpdatePositionParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"new_title": {
"type": [
"string",
"null"
],
"description": "New title (optional)"
},
"position_id": {
"type": [
"string",
"null"
],
"description": "Position ID (optional if position_title is provided)"
},
"position_title": {
"type": [
"string",
"null"
],
"description": "Position title to find (optional if position_id is provided)"
},
"new_description": {
"type": [
"string",
"null"
],
"description": "New description (optional)"
},
"new_permissions": {
"description": "New permissions JSON object mapping permission keys to booleans, e.g. {\"can_view_all_projects\": true}. Use list_positions to see all available keys."
}
}
}Update a project's name, description, or links. Find by name or ID.
| Argument | Type | Description |
|---|---|---|
| links | any | Links as JSON array: [{"label": "...", "url": "...", "type": "..."}] (optional) |
| new_name | string | null | New name (optional) |
| project_id | string | null | Project ID (optional if project_name is provided) |
| project_name | string | null | Project name to find (optional if project_id is provided) |
| new_description | string | null | New description (optional) |
{
"type": "object",
"title": "UpdateProjectParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"links": {
"description": "Links as JSON array: [{\"label\": \"...\", \"url\": \"...\", \"type\": \"...\"}] (optional)"
},
"new_name": {
"type": [
"string",
"null"
],
"description": "New name (optional)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional if project_name is provided)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name to find (optional if project_id is provided)"
},
"new_description": {
"type": [
"string",
"null"
],
"description": "New description (optional)"
}
}
}Update a task's status, title, description, priority, or team assignment. Use this to move tasks through the workflow (todo -> in_progress -> done) or reassign to a team.
| Argument | Type | Description |
|---|---|---|
| tags | array | null | New tags (replaces existing tags) |
| title | string | null | New title |
| due_at | string | null | Due date in ISO 8601 format (e.g. '2026-03-15T00:00:00Z'), or null to clear |
| status | string | null | New status: todo, in_progress, done, cancelled |
| task_id* | string | Task ID to update |
| team_id | string | null | Team ID to assign (optional) |
| priority | string | null | New priority: low, medium, high, urgent |
| team_name | string | null | Team name to assign (optional, alternative to team_id) |
| description | string | null | New description |
Update a team's name, description, or objectives. Find by name or ID.
| Argument | Type | Description |
|---|---|---|
| team_id | string | null | Team ID (optional if team_name is provided) |
| new_name | string | null | New name (optional) |
| team_name | string | null | Team name to find (optional if team_id is provided) |
| new_objectives | array | null | New objectives (optional) |
| new_description | string | null | New description (optional) |
{
"type": "object",
"title": "UpdateTeamParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (optional if team_name is provided)"
},
"new_name": {
"type": [
"string",
"null"
],
"description": "New name (optional)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name to find (optional if team_id is provided)"
},
"new_objectives": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "New objectives (optional)"
},
"new_description": {
"type": [
"string",
"null"
],
"description": "New description (optional)"
}
}
}Update an existing user's name, role, positions, or skills (admin/owner only).
| Argument | Type | Description |
|---|---|---|
| user* | string | User name or email to find |
| skills | array | null | Skills list (optional — replaces existing) |
| new_name | string | null | New name (optional) |
| new_role | string | null | New role: member or admin (optional) |
| positions | array | null | Position titles to assign (optional — replaces existing) |
{
"type": "object",
"title": "UpdateUserParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user"
],
"properties": {
"user": {
"type": "string",
"description": "User name or email to find"
},
"skills": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Skills list (optional — replaces existing)"
},
"new_name": {
"type": [
"string",
"null"
],
"description": "New name (optional)"
},
"new_role": {
"type": [
"string",
"null"
],
"description": "New role: member or admin (optional)"
},
"positions": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Position titles to assign (optional — replaces existing)"
}
}
}Upload a document to the organization's knowledge base. Documents can be templates, policies, contracts, procedures, guides, or references. They are indexed in the knowledge graph and automatically surfaced as context when relevant to a task. Supports both text and binary files: for binary files (PDFs, images, etc.), set is_base64=true and provide the content as a base64-encoded string, along with the appropriate mime_type (e.g. 'application/pdf', 'image/png'). Optionally set file_name for the original filename. Embeddings are generated automatically for search.
| Argument | Type | Description |
|---|---|---|
| tags | array | null | Tags for categorization and search (e.g. ['tax', 'contract', 'template']) |
| title* | string | Document title |
| content* | string | Full document content (text/markdown) |
| category* | string | Category: template, policy, procedure, reference, contract, guide, checklist, other |
| team_ids | array | null | Team IDs to associate with (optional, alternative to team_names) |
| file_name | string | null | Original file name (e.g. 'contract.pdf'). Optional. |
| is_base64 | boolean | null | Set to true if content is base64-encoded (for binary files like PDFs, images) |
Get your profile, organization, projects, recent sessions, and top entities. This is the best starting point — call this first to understand what's available. No parameters needed.
No arguments.
{
"type": "object",
"title": "EmptyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}| description |
| string | null |
| Task description (optional) |
| project_name | string | null | Project name to create the task in |
| sprint_number | integer | null | Sprint number to assign the task to (optional — auto-assigns to current sprint if omitted) |
{
"type": "object",
"title": "CreateTaskParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Tags for categorization (e.g. ['bug', 'frontend'])"
},
"title": {
"type": "string",
"description": "Task title"
},
"due_at": {
"type": [
"string",
"null"
],
"description": "Due date in ISO 8601 format (e.g. '2026-03-15T00:00:00Z')"
},
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID (alternative to team_name)"
},
"priority": {
"type": [
"string",
"null"
],
"description": "Priority: low, medium, high, urgent (default: medium)"
},
"assignees": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Assignee names or emails (optional — resolves to user IDs)"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name to assign to (optional — resolves to team ID)"
},
"depends_on": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Task IDs that this task depends on / is blocked by (optional). Creates 'blocks' dependencies."
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (alternative to project_name)"
},
"description": {
"type": [
"string",
"null"
],
"description": "Task description (optional)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name to create the task in"
},
"sprint_number": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Sprint number to assign the task to (optional — auto-assigns to current sprint if omitted)"
}
}
}| project_name |
| string | null |
| Project name (optional, used for auto-session resolution) |
| parent_trace_id | string | null | Parent trace ID for nesting (e.g. tool_call -> file_reads) |
{
"type": "object",
"title": "LogTraceParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trace_type",
"summary"
],
"properties": {
"status": {
"type": [
"string",
"null"
],
"description": "Status: started, completed, failed (default: completed)"
},
"summary": {
"type": "string",
"description": "Short description of the action"
},
"task_id": {
"type": [
"string",
"null"
],
"description": "Task ID to link this trace to (optional — auto-links session to task)"
},
"metadata": {
"description": "Free-form JSON metadata (optional)"
},
"trace_id": {
"type": [
"string",
"null"
],
"description": "Logical trace group ID (auto-generated if omitted)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID (optional, alternative to project_name)"
},
"session_id": {
"type": [
"string",
"null"
],
"description": "Session ID (optional — auto-resolved from project if omitted)"
},
"trace_type": {
"type": "string",
"description": "Trace type: tool_call, file_read, file_write, code_search, code_edit, api_call, thinking, error"
},
"duration_ms": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Duration in milliseconds (optional)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name (optional, used for auto-session resolution)"
},
"parent_trace_id": {
"type": [
"string",
"null"
],
"description": "Parent trace ID for nesting (e.g. tool_call -> file_reads)"
}
}
}{
"type": "object",
"title": "UpdateTaskParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "New tags (replaces existing tags)"
},
"title": {
"type": [
"string",
"null"
],
"description": "New title"
},
"due_at": {
"type": [
"string",
"null"
],
"description": "Due date in ISO 8601 format (e.g. '2026-03-15T00:00:00Z'), or null to clear"
},
"status": {
"type": [
"string",
"null"
],
"description": "New status: todo, in_progress, done, cancelled"
},
"task_id": {
"type": "string",
"description": "Task ID to update"
},
"team_id": {
"type": [
"string",
"null"
],
"description": "Team ID to assign (optional)"
},
"priority": {
"type": [
"string",
"null"
],
"description": "New priority: low, medium, high, urgent"
},
"team_name": {
"type": [
"string",
"null"
],
"description": "Team name to assign (optional, alternative to team_id)"
},
"description": {
"type": [
"string",
"null"
],
"description": "New description"
}
}
}| mime_type | string | null | MIME type of the content (default: text/plain). Use application/pdf, image/png, etc. for binary files. |
| project_id | string | null | Project ID to associate with (optional, alternative to project_name) |
| team_names | array | null | Team names to associate the document with (optional, for team-level access control) |
| project_name | string | null | Project name to associate with (optional) |
{
"type": "object",
"title": "UploadDocumentParams",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"category",
"content"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Tags for categorization and search (e.g. ['tax', 'contract', 'template'])"
},
"title": {
"type": "string",
"description": "Document title"
},
"content": {
"type": "string",
"description": "Full document content (text/markdown)"
},
"category": {
"type": "string",
"description": "Category: template, policy, procedure, reference, contract, guide, checklist, other"
},
"team_ids": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Team IDs to associate with (optional, alternative to team_names)"
},
"file_name": {
"type": [
"string",
"null"
],
"description": "Original file name (e.g. 'contract.pdf'). Optional."
},
"is_base64": {
"type": [
"boolean",
"null"
],
"description": "Set to true if content is base64-encoded (for binary files like PDFs, images)"
},
"mime_type": {
"type": [
"string",
"null"
],
"description": "MIME type of the content (default: text/plain). Use application/pdf, image/png, etc. for binary files."
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project ID to associate with (optional, alternative to project_name)"
},
"team_names": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Team names to associate the document with (optional, for team-level access control)"
},
"project_name": {
"type": [
"string",
"null"
],
"description": "Project name to associate with (optional)"
}
}
}