The AgentDraft MCP server.
agentdraft-mcp gives any MCP client — Claude Desktop, Claude Code, Cursor, Cline — race-free scheduling over the Model Context Protocol. Your agent gets availability, holds, commits, and cancellations as first-class tools, and the conflict engine makes sure two agents never double-book the same slot.
Updated
The Model Context Protocol lets an AI client call external tools through a uniform interface. The AgentDraft MCP server exposes the scheduling coordination layer as six of those tools. It is a thin wrapper over the agentdraft Python SDK — same auth, same typed errors, same race semantics as the REST API and the language SDKs. Point your agent at it and every booking it makes is arbitrated against every other agent on the calendar.
Requires Python 3.10+ and an avs_live_… agent key from your dashboard. The free Developer tier issues one instantly, no card required.
- Install the server.
pip install agentdraft-mcp
- Claude Desktop / Claude Code — JSON config. Add the server to claude_desktop_config.json and paste your API key:
{ "mcpServers": { "agentdraft": { "command": "agentdraft-mcp", "env": { "AGENTDRAFT_API_KEY": "avs_live_..." } } } } - Cursor / Cline / any stdio host.
{ "mcpServers": { "agentdraft": { "command": "python", "args": ["-m", "agentdraft_mcp"], "env": { "AGENTDRAFT_API_KEY": "avs_live_..." } } } }
| Tool | What it does |
|---|---|
| whoami | Confirm the API key and return the agent's identity, priority, and scopes. |
| get_availability | List slots open to the calling agent in a window, filtered through focus blocks, buffers, and sibling holds. |
| create_hold | Reserve a slot tentatively (30s TTL). Returns an outranked payload if a higher-priority agent already holds it. |
| release_hold | Release a hold early so other agents can claim the slot before the TTL expires. |
| commit_booking | Finalize a booking — the atomic slot-level compare-and-swap. Exactly one agent wins; losers get a typed 409. |
| cancel_booking | Cancel a committed booking and free the slot for other agents. |
Most MCP scheduling servers hand an agent a thin wrapper over a single calendar's API. That gives every agent its own private view and no arbitration — so two agents that both read a free slot can both write it, and a human ends up double-booked.
AgentDraft's server routes every commit_booking through the conflict engine first. Each booking is written as one row per fixed time bucket inside a single DynamoDB TransactWriteItems; the ConditionExpression lets a higher-priority agent evict a lower-priority hold or a still-bumpable commit. Exactly one writer wins each slot in any race window, and every loser receives a typed outranked response with the winner's priority — the check is the write. See the glossary entry for the formal model.
Frequently asked
What is the AgentDraft MCP server?
agentdraft-mcp is a Model Context Protocol server that exposes AgentDraft's scheduling API as tools — whoami, get_availability, create_hold, release_hold, commit_booking, and cancel_booking — to any MCP host such as Claude Desktop, Claude Code, Cursor, or Cline.
How do I install it?
Run pip install agentdraft-mcp, then add it to your MCP client config with the command agentdraft-mcp and an AGENTDRAFT_API_KEY environment variable holding your avs_live_ agent key. The same JSON works for Claude Desktop, Claude Code, Cursor, and Cline.
Why use this instead of calling the calendar directly?
A direct calendar call gives each agent its own view and no arbitration, so two agents can both book the same slot. The AgentDraft MCP server routes every booking through the conflict engine first: exactly one agent wins each slot via a storage-level conditional write, and every loser gets a typed outranked response with the winner's priority.
Which MCP clients are supported?
Any MCP host that speaks stdio — Claude Desktop, Claude Code, Cursor, Cline, and OpenAI Agents SDK apps among them. The server requires Python 3.10+ and a valid AgentDraft agent key.
- Calendar API for AI agents — the HTTP surface the MCP server wraps.
- LangChain & CrewAI tools — the same coordination layer for code-first agent frameworks.
- Quickstart — issue a key and commit your first booking in under three minutes.