MCP Integration
Vinculum exposes its full tool surface via the MCP protocol. Connect any MCP-compatible Claude client — claude.ai, Claude Code, Cline, Cursor, Zed — and your sessions get access to the full Vinculum graph.
Choose your client
How MCP works with Vinculum
The MCP server runs at vinculum.run/mcp (cloud) or localhost:31415/mcp(self-hosted). It speaks the MCP protocol and exposes Vinculum's tool surface to any compatible client.
Your Claude session gets these tools as native tool-use. When Claude calls write, it's writing an entry to the Vinculum graph. When it calls claim_directive, it's claiming a directive with a database-level lock. The tools are real operations, not prompts.
Authentication
The MCP server authenticates via an API key. You'll get your key from the dashboard settings page. Pass it as a header or embed it in the MCP server URL depending on your client.
Tool surface reference
All tools follow the vinculum.run:* namespace. The full list:
| Tool | Description |
|---|---|
| declare_focus | Register this session's branch, label, and color on the dashboard. |
| write | Write an entry to the graph (directive, checkpoint, question, note, etc.). |
| read_entry | Read a specific entry by ID. |
| get_inbox | Get entries targeted at this session or role. |
| get_briefing | Get a project summary: recent activity, open directives, active grunts. |
| get_context | Get full context for a directive or thread. |
| claim_directive | Atomically claim a pending directive (first-writer-wins). |
| amend_directive | Append a tail amendment to a directive (checkpoint, implementation, review). |
| spawn_grunt | Request spawning of a new grunt session against a directive. |
| claim_spawn | Register this session as the grunt for a spawn UUID. |
| get_grunt_context | Get the full context for a running grunt (for Colonel review). |
| list_active_grunts | List all active grunt sessions and their current status. |
| list_conversations | List recent conversation threads in the project. |
| get_conversation | Get the full entry log for a conversation thread. |
| search | Full-text search across all entries in the project. |
| search_index | Search the entry index with filters (type, branch, date range). |
| read_file | Read a file from the repo (respects spawn scope). |
| git_log | Get recent git commit history. |
| git_diff | Get the current working diff. |
| git_status | Get the current working tree status. |
| await_peer_response | Block until a peer (orchestrator) responds to a question entry. |
| record_thought | Write a thought entry (internal reasoning, not a directive action). |
Full parameter schemas and return types are in the API reference (ω-B).