ContextLayer is an MCP server published by io.github.DotNova, hosted at api.dotnova.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 62 tools, including accept_org_invite, add_task_dependency, add_team_member, assign_task, create_position.
Intelligent context infrastructure for AI teams: knowledge graph, sessions, tasks, documents.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Accept a pending organization invite by organization name.
| Parameter | Type | Description |
|---|---|---|
| org_name * | string | Organization name to accept the invite for |
{
"name": "accept_org_invite",
"description": "Accept a pending organization invite by organization name.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "add_task_dependency",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "add_team_member",
"description": "Add a member to a team. Find the team by name or ID, and the user by name or email.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| user * | string | User name or email to assign |
| task_id * | string | Task ID |
{
"name": "assign_task",
"description": "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.",
"inputSchema": {
"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).
| Parameter | 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. |
{
"name": "create_position",
"description": "Create a new job position/title in your organization (admin only).",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Project name |
| description | ["string","null"] | Project description (optional) |
{
"name": "create_project",
"description": "Create a new project in your organization. You will be added as the project owner.",
"inputSchema": {
"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.
| Parameter | 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 |
{
"name": "create_sprint",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
| description | ["string","null"] | Task description (optional) |
| project_name |
Create a new team in your organization. You will be added as team lead.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Team name |
| objectives | ["array","null"] | Team objectives as a list of strings (optional) |
| description | ["string","null"] | Team description (optional) |
{
"name": "create_team",
"description": "Create a new team in your organization. You will be added as team lead.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| document_id * | string | Document ID to delete |
{
"name": "delete_document",
"description": "Delete a document from the knowledge base. This permanently removes the document.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "delete_position",
"description": "Delete a position permanently (admin only). Find by title or ID.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "delete_project",
"description": "Delete a project permanently (admin only). Find by name or ID.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | Task ID to delete |
{
"name": "delete_task",
"description": "Delete a task permanently. The task and all its assignee links are removed.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "delete_team",
"description": "Delete a team permanently (admin only). Find by name or ID.",
"inputSchema": {
"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).
| Parameter | Type | Description |
|---|---|---|
| user * | string | User name or email to delete |
{
"name": "delete_user",
"description": "Delete (soft-delete) a user from your organization (admin/owner only).",
"inputSchema": {
"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.
| Parameter | 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. |
{
"name": "end_session",
"description": "End a work session. This triggers context block generation — your activities are summarized and stored in the knowledge graph for future reference.",
"inputSchema": {
"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.
| Parameter | 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 |
{
"name": "find_documents",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "get_context",
"description": "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.",
"inputSchema": {
"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 parameters.
{
"name": "get_context_routing",
"description": "Get the current context routing mode for the organization. Returns 'keyword_llm', 'keyword_only', or 'llm_only'.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| document_id * | string | Document ID |
{
"name": "get_document",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "get_live_activity",
"description": "See what's happening right now: active sessions, recent events, traces, and tasks being worked on.",
"inputSchema": {
"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 parameters.
{
"name": "get_my_stats",
"description": "Get your personal activity statistics: total sessions, events, active days, projects worked on, and recent activity summary.",
"inputSchema": {
"type": "object",
"title": "EmptyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
}Get comprehensive organization statistics: counts, engagement metrics, task velocity.
No parameters.
{
"name": "get_org_stats",
"description": "Get comprehensive organization statistics: counts, engagement metrics, task velocity.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "get_project_status",
"description": "Get the current status of a project including recent activity. You can use either the project name or ID.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | Session ID to get details for |
{
"name": "get_session_details",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "get_team_details",
"description": "Get detailed information about a team: members (with roles), linked projects, and recent activity. Use team name or ID.",
"inputSchema": {
"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).
| Parameter | 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) |
{
"name": "invite_user",
"description": "Invite a new member to your organization (admin/owner only).",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | Task ID to link |
| session_id * | string | Session ID to link to the task |
{
"name": "link_task_session",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "link_team_project",
"description": "Link a project to a team. Find both by name or ID.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| limit | ["integer","null"] | Maximum results (default 20) |
| team_name | ["string","null"] | Filter by team name (optional — shows only members of that team) |
{
"name": "list_colleagues",
"description": "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.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| limit | ["integer","null"] | Maximum results (default 20) |
| unread_only | ["boolean","null"] | Only return unread notifications (default: true) |
{
"name": "list_notifications",
"description": "List your notifications — task assignments, status changes, sprint updates, invites, and more. Returns unread notifications by default.",
"inputSchema": {
"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 parameters.
{
"name": "list_pending_invites",
"description": "List pending organization invites for the current user.",
"inputSchema": {
"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 parameters.
{
"name": "list_positions",
"description": "List all job positions/titles in your organization with member counts.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| project_id | ["string","null"] | Project ID |
| project_name | ["string","null"] | Project name (alternative to project_id) |
{
"name": "list_project_members",
"description": "List all members involved in a project. Includes users who have sessions in the project and users from teams linked to the project.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| project_id | ["string","null"] | Project ID |
| project_name | ["string","null"] | Project name (alternative to project_id) |
{
"name": "list_project_teams",
"description": "List teams linked to a project.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| org_id | ["string","null"] | Optional organization ID (uses default org if omitted) |
{
"name": "list_projects",
"description": "List projects in your organization. No parameters needed — just call it to see all your projects.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "list_sessions",
"description": "List your recent work sessions. Optionally filter by project name or ID. Shows task type, status, and event count.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| project_id | ["string","null"] | Project ID (alternative to project_name) |
| project_name | ["string","null"] | Project name |
{
"name": "list_sprints",
"description": "List sprints for a project. Shows sprint number, name, goal, status (current/completed), and task count.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "list_tasks",
"description": "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.",
"inputSchema": {
"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 parameters.
{
"name": "list_teams",
"description": "List all teams in your organization. Shows team name, member count, project count, and description.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "log_activity",
"description": "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.",
"inputSchema": {
"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.
| Parameter | 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) |
| project_name | ["string","null"] | Project name (optional, used for auto-session resolution) |
Log multiple traces in a single batch.
| Parameter | Type | Description |
|---|---|---|
| traces * | array | Array of traces to log in a single batch |
{
"name": "log_traces_batch",
"description": "Log multiple traces in a single batch.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "mark_notification_read",
"description": "Mark a notification as read, or mark all notifications as read at once.",
"inputSchema": {
"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.
| Parameter | 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 |
{
"name": "move_task_to_sprint",
"description": "Move a task to a different sprint. Specify the target sprint by number or ID.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | The task that was blocked |
| depends_on_task_id * | string | The task that was blocking it |
{
"name": "remove_task_dependency",
"description": "Remove a dependency between tasks. This unblocks the task from the other task.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "remove_team_member",
"description": "Remove a member from a team. Find the team by name or ID, and the user by name or email.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| user * | string | User name or email to remove from the organization |
{
"name": "remove_user_from_org",
"description": "Remove a user from the current organization without deleting their account. Admin/owner only.",
"inputSchema": {
"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.
| Parameter | 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 |
{
"name": "search_entities",
"description": "Search entities in the knowledge graph by name. Finds people, companies, documents, concepts, tools, etc. that have been mentioned in your activities.",
"inputSchema": {
"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).
| Parameter | Type | Description |
|---|---|---|
| mode * | string | Routing mode: 'keyword_llm' (keyword + LLM fallback), 'keyword_only' (fastest), or 'llm_only' (most accurate) |
{
"name": "set_context_routing",
"description": "Set the context routing mode for the organization. Requires admin role. Options: 'keyword_llm' (balanced), 'keyword_only' (fastest), 'llm_only' (most accurate).",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "setup_organization",
"description": "Set up your organization in one step (admin only). Use this for onboarding.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "start_session",
"description": "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.",
"inputSchema": {
"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.
| Parameter | Type | Description |
|---|---|---|
| task_id * | string | Task ID |
| user_id * | string | User ID to remove from assignees |
{
"name": "unassign_task",
"description": "Remove a user from a task's assignees.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "unlink_team_project",
"description": "Unlink a project from a team. Find both by name or ID.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "update_org",
"description": "Update your organization's details (owner only). Set name, description, business model, objectives, custom context for AI, or links.",
"inputSchema": {
"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.
| Parameter | 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. |
{
"name": "update_position",
"description": "Update a position's title, description, or permissions (admin only). Find by title or ID.",
"inputSchema": {
"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.
| Parameter | 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) |
{
"name": "update_project",
"description": "Update a project's name, description, or links. Find by name or ID.",
"inputSchema": {
"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.
| Parameter | 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 |
{
"name": "update_task",
"description": "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.",
"inputSchema": {
"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"
}
}
}
}Update a team's name, description, or objectives. Find by name or ID.
| Parameter | 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) |
{
"name": "update_team",
"description": "Update a team's name, description, or objectives. Find by name or ID.",
"inputSchema": {
"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).
| Parameter | 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) |
{
"name": "update_user",
"description": "Update an existing user's name, role, positions, or skills (admin/owner only).",
"inputSchema": {
"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.
| Parameter | 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) |
| mime_type | ["string","null"] | MIME type of the content (default: text/plain). Use application/pdf, image/png, etc. for binary files. |
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 parameters.
{
"name": "whoami",
"description": "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.",
"inputSchema": {
"type": "object",
"title": "EmptyParams",
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
}You are connected to ContextLayer — an intelligent context infrastructure for AI teams. **IMPORTANT — MANDATORY FIRST ACTION:** At the very beginning of each new conversation, before doing ANY other work, you MUST automatically start a session: 1. Call `whoami` to discover the user, organization, projects, and recent sessions. 2. Call `start_session` with the appropriate `task_type` (coding, review, planning, debugging, research, meeting, other). - If the work is clearly tied to one of the user's projects, pass `project_name` so the session is linked to that project. - **If the work has no obvious project link (general questions, exploration, off-project chat), call `start_session` WITHOUT a project_name/project_id.** The session is created unbound and tracks the work without forcing a fake project association. 3. Never ask the user "do you want to use ContextLayer?" — start the session silently. The user has already opted in by enabling this MCP server. Projectless sessions behave like normal sessions for tracking purposes. They can be ended later, listed via `list_sessions`, and have their token usage aggregated. They simply do not contribute to project-level context blocks. ## Workflow (after auto-start) 1. Use `get_context` with a descriptive query — the system intelligently routes to the right data sources (tasks, sessions, documents, teams, blocks) based on intent analysis, graph traversal, and semantic similarity 2. For project-specific info, use `get_project_status` with the project name or `get_context` with a query 3. Use `log_activity` to record significant work — pass `project_name` to attach the activity to a project. (Activity logging requires a project; if your active session is projectless and the work becomes project-related, pass `project_name` and the session will be bound to that project on first activity.) 4. Sessions close automatically after inactivity — no need to call `end_session` (but you can) ## Teams & Colleagues - `whoami` already shows the user's team memberships — use this to answer 'what team am I on?' - Use `list_teams` to see all teams in the organization - Use `get_team_details` with a team name to see members, linked projects, and recent activity - Use `list_colleagues` to find people — filters by team name; members see their teammates, admins see everyone - Use `get_my_stats` for personal activity statistics and performance overview ## Tasks - Use `create_task` to create tasks in a project — assign to people by name, set priority, tags, team, and due date - Use `list_tasks` to see tasks — filter by project, status, sprint number, or your own tasks with mine_only - Use `update_task` to change status (todo -> in_progress -> done), priority, description, tags, or due date - Use `delete_task` to permanently remove a task - Use `assign_task` to add a user to a task by name or email - Use `unassign_task` to remove a user from a task - Use `link_task_session` to connect a work session to a task — this feeds the knowledge graph - When starting a session for a task, proactively link it with link_task_session ## Sprints - Use `list_sprints` to see all sprints in a project (backlog, active, completed) - Use `create_sprint` to create a new sprint — automatically migrates non-completed tasks from the previous sprint - Use `move_task_to_sprint` to move a task between sprints - Tasks created via `create_task` are auto-assigned to the current sprint; use `sprint_number` to override - Filter tasks by sprint using `list_tasks` with `sprint_number` parameter ## Projects - Use `list_project_members` to see all members involved in a project (from sessions and team links) - Use `list_project_teams` to see teams linked to a project ## Documents & Templates - Use `upload_document` to store templates, policies, contracts, guides in the knowledge base - Use `find_documents` to search for relevant documents by category, tags, or text - Use `get_document` to read full document content - Use `delete_doc
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| ["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) |
{
"name": "create_task",
"description": "Create a new task in a project. Tasks track work items and can be assigned to team members and linked to sessions.",
"inputSchema": {
"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)"
}
}
}
}| parent_trace_id | ["string","null"] | Parent trace ID for nesting (e.g. tool_call -> file_reads) |
{
"name": "log_trace",
"description": "Log a granular agent action trace. High-frequency, no LLM processing.",
"inputSchema": {
"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)"
}
}
}
}| 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) |
{
"name": "upload_document",
"description": "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.",
"inputSchema": {
"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)"
}
}
}
}