MCP Tools Reference
The Agenties MCP server exposes all of the following tools to every Claude Code agent running in a project. The server runs on localhost and is automatically registered with Claude Code when Agenties starts. Integration tools such as WordPress, Insforge, Supabase, Vercel, Graphify, and Google Workspace are available when their corresponding connector or project configuration is present.
Note:Tools are available to all agents regardless of role, but the orchestrator's system prompt instructs it to restrict delegation tools (
spawn_agent, cancel_spawn) to itself. Sub-agents should not call spawn_agent directly — use the coordinator role for multi-step delegation.Delegation
Spawn and manage sub-agents. Only the orchestrator should use these tools.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
spawn_agent | memberId, role, task, context?, issueId?, parentSessionId? | { agentId, sessionId } | Spawn a new Claude Code sub-agent using the specified team member. The agent receives a task-assigned message and starts executing. Returns immediately — the agent runs asynchronously. |
cancel_spawn | agentId | { ok } | Send a cancel signal to a running agent. Initiates the BFS cancel cascade: leaf agents cancel first, then parent coordinators. |
Team
Read and manage the team roster.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
list_team | role?, excludeOff? | TeamMember[] | List all team members. Optionally filter by role and exclude members with effort=off. |
get_team_member | memberId | TeamMember | Get a specific team member by ID. |
hire_team_member | name, role, model, effort, baseInstructions | TeamMember | Create a new team member. Used by the orchestrator in autonomous hiring mode. The new member is persisted to team.json and synced. |
update_team_member | memberId, fields: Partial<TeamMember> | TeamMember | Update one or more fields of a team member. Cannot change the id field. |
fire_team_member | memberId | { ok } | Remove a team member from the roster. Running agents using this member finish their current task. |
Vault / Memory
Read and write to the Obsidian vault and shared operational state. NotebookLM is configured from Settings as an optional session memory provider.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
get_shared_state | — | SharedState | Get the current shared operational state: phase, objective, active agents, open work items, and recent decisions. |
read_vault_note | path: string | { content: string } | Read a note from the project vault by relative path. |
write_vault_note | path, content | { ok } | Write or overwrite a vault note. Creates parent directories if needed. |
append_vault_note | path, content | { ok } | Append content to a vault note. Creates the file if it does not exist. Appends a newline before content if the file is non-empty. |
list_vault_notes | prefix?: string | string[] | List all notes in the vault (or a subdirectory). Returns paths relative to vault root. |
Mailbox
Send and receive messages between agents.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
read_messages | to?, since?, unreadOnly?, limit? | MailboxMessage[] | Read messages from the mailbox. Default: unread messages addressed to the calling agent. |
send_message | type, to, subject?, body, metadata?, issueId? | MailboxMessage | Post a message to the mailbox. task-done and review-result messages auto-wake the orchestrator. |
mark_read | messageIds? | all? | { ok } | Mark messages as read to prevent re-delivery on subsequent read_messages calls. |
Issues
Create and manage the project issue tracker.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
create_issue | title, description?, priority?, labels? | Issue | Create a new issue with status=open. The issue is persisted locally and synced when project sync is enabled. |
update_issue | issueId, fields: Partial<Issue> | Issue | Update issue fields. Use to transition status (open→in_progress→done), set priority, add a description, or link an agent. |
list_issues | status?, priority?, assignee?, label?, limit? | Issue[] | List issues with optional filters. Default: all open issues sorted by priority descending. |
Project & Config
Read project metadata, configuration, and navigate between projects.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
get_project | — | Project | Get the current project details: name, path, backendProjectId, vault path, and sync status. |
get_config | key?: string | Config | value | Read the project configuration. Pass a key to read a specific field (e.g. "heartbeat", "toolPermissions"). |
list_projects | — | Project[] | List all projects registered in Agenties on this machine. |
list_agents | status?, limit? | AgentRecord[] | List agent run history for the current project. Filter by status (running, done, error, cancelled). |
get_activity | since?, limit? | ActivityEvent[] | Get recent activity events: agent spawns, completions, issue changes, and sync events. |
switch_project | projectId | { ok } | Switch the active project in the Agenties UI. Orchestrator processes for the previous project are paused. |
remove_project | projectId | { ok } | Unregister a project from Agenties. Does not delete the .agenties/ directory or the project files. |
create_project | name, path, companyId? | Project | Register a new project. Creates .agenties/ in the given path and initialises state files. |
Companies
Manage company groupings for organising projects.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
list_companies | — | Company[] | List all companies. |
create_company | name | Company | Create a new company. |
rename_company | companyId, name | Company | Rename an existing company. |
delete_company | companyId | { ok } | Delete a company. Projects in the company are moved to the ungrouped list. |
Permissions
Request human approval before performing sensitive operations.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
request_permission | tool, input, reason? | { granted: boolean } | Show a permission card to the user asking to approve a tool call. The agent is paused until the user decides. Returns granted=true if approved, false if denied or timed out. |
Artifacts
Render rich content in the Agenties chat side drawer.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
render_artifact | type: "html" | "svg" | "markdown", content, title? | { artifactId } | Render content in the side drawer panel next to the chat. HTML artifacts are sandboxed in an iframe. SVG is rendered directly. Markdown is rendered with full styling. Great for diagrams, reports, and interactive demos. |
Continuity
Read and write durable project continuity without loading large chat histories.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
build_init_context | projectCwd?, query?, maxBytes?, maxNotes? | { text, metadata } | Build compact startup context from shared state, continuity journal, continuity index, and configured vault excerpts. |
append_journal_entry | title, status, summary, paths?, next?, projectCwd? | { appended, mirrored } | Append a compact entry to .agenties/continuity/journal.md. Used after significant task completions. |
read_journal_entries | projectCwd?, maxDays?, maxEntries?, format? | { text | entries } | Read recent continuity journal entries in a token-safe format. |
search_vault_notes | query, folder?, tags?, limit? | SearchResult[] | Search Obsidian vault notes with caps on file count, result count, and excerpt size. |
Frugal self-improvement
Track recurring friction and propose one low-cost improvement on demand.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
append_improvement_signal | type, key, metadata?, projectCwd? | { appended, type, key } | Append one cheap local signal to .agenties/self-improvement/signals.jsonl. No model is invoked. |
suggest_improvement | projectCwd?, windowDays?, threshold? | { deferred, proposal?, candidateCount? } | Aggregate signals and return exactly one ROI-annotated proposal. Blocks only when activeRunPressure is high; historical pressure is advisory. |
Insforge
Inspect and query a user-configured Insforge project from Agenties.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
insforge_list_tables | - | Table[] | List tables available in the configured Insforge project. |
insforge_list_buckets | - | Bucket[] | List storage buckets available in the configured Insforge project. |
insforge_run_sql | sql, params? | { rows, rowCount, fields } | Execute raw SQL on the configured Insforge project and return rows, row count, and fields. |
Supabase
Inspect and query a configured Supabase project from Agenties.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
supabase_list_tables | - | Table[] | List tables available in the configured Supabase project. |
supabase_execute_sql | sql | QueryResult | Execute raw SQL on the configured Supabase project and return query results. |
Vercel
Inspect recent deployments, deployment details, and build logs.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
vercel_list_deployments | limit? | Deployment[] | List recent deployments from the configured Vercel account or team. |
vercel_get_deployment | deploymentId | Deployment | Get detailed deployment status, aliases, git metadata, and inspector URL. |
vercel_get_build_logs | deploymentId | BuildLog[] | Read build logs for a deployment, usually after a failed or stuck build. |
WordPress
Control WordPress sites through the Agenties WordPress connector and plugin tunnel.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
wordpress_status | projectCwd? | WordPressStatus | Read configured WordPress connection status. |
wordpress_get_capabilities | projectCwd? | Capabilities | Detect WordPress/PHP versions, active stack, notable plugins, and recommended skills. |
wordpress_create_page | title, content, projectCwd? | Page | Create a draft page through the connector. Publishing remains outside this tool. |
wordpress_run_db_query | sql, confirm?, backupConfirmation?, projectCwd? | QueryResult | Run guarded database queries when the project tier permits db_ops. |
wordpress_execute_php | code, destructiveConfirmation?, projectCwd? | PhpResult | Execute PHP only when php_exec is enabled and the user has accepted the session risk. |
wordpress_set_access | riskTier, projectCwd? | { ok } | Set the Agenties-side WordPress access tier: read_only, content_write, admin_ops, db_ops, or php_exec. |
Knowledge Graph
Query the Graphify codebase index for fast file-level pre-search before broad scans.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
graph_status | projectCwd? | { installed, graphPath, lastUpdated } | Check whether the Graphify knowledge graph is installed for the current project, where the graph file is stored, and when it was last built. If installed: false or lastUpdated is older than 7 days, skip to normal scouting. |
graph_query | question, projectCwd? | FileMatch[] | Query the knowledge graph with a natural-language question. Returns a ranked list of file paths most relevant to the question. Use as a fast pre-search before spawning a scout or running broad codebase scans. |
graph_update | projectCwd? | { ok, filesIndexed } | Rebuild the knowledge graph index for the current project. Run after significant codebase changes, major refactors, or when the graph is stale (>7 days). |
Google Workspace
Read and write Gmail, Google Calendar, and Google Drive through the connected Google account.
| Tool | Parameters | Returns | Description |
|---|---|---|---|
google_workspace_status | — | { connected, email, scopes } | Check the Google Workspace connection status. Returns the connected account email and which OAuth scopes are available (Gmail, Calendar, Drive). |
gmail_read | query?, maxResults? | GmailMessage[] | List Gmail messages from the connected account. Supports Gmail search syntax (from:, subject:, is:unread, newer_than:7d, etc.). Returns message ids and snippets. |
gmail_send | to, subject, body | Google API response | Send a plain-text email from the connected Google account. |
calendar_list | calendarId?, timeMin?, maxResults? | CalendarEvent[] | List upcoming calendar events. Defaults to the primary calendar and now as the lower bound. |
calendar_create | summary, start, end, description?, calendarId? | CalendarEvent | Create a Google Calendar event. start and end must be RFC3339 dateTime strings. |
drive_read | fileId?, query?, pageSize? | DriveFile[] | List Drive files with an optional query, or read one downloadable file by ID using alt=media. |
drive_upload | name, content, mimeType? | Google API response | Upload a small plain-text file to Google Drive. |