agentdraft-mcp — MCP server for AgentDraft

An MCP server that exposes AgentDraft — the ops API for AI agents with inbox, conflict-free calendar, and audit tools — as a set of tools any MCP-aware AI client can call.

Use this if your agent runtime is Claude Desktop, Claude Code, Cursor, Cline, an OpenAI Agents SDK app, or any other MCP host. The server is a thin wrapper around the agentdraft Python SDK — same auth, same errors, same semantics as the REST API and the language SDKs.

Tools

Nine tools, grouped by what they coordinate:

• Scheduling — whoami, get_availability, create_hold, release_hold, commit_booking, cancel_booking.

• Human approval — request_approval, get_approval, wait_for_approval. Open a gate before a consequential action and resume only when a person decides. The wait is clamped to 120 seconds; a timeout returns status: "pending", never a false approval.

approval = await tools.request_approval(
    action_type="deploy.production",
    summary="Ship v0.2.0 to production",
    evidence={"commit": "a1b2c3d", "migrations": 2},
)
result = await tools.wait_for_approval(approval["approval_id"], timeout_seconds=60)
if result["status"] != "approved":
    raise SystemExit(f"stood down: {result['status']}")

An interactive config generator for every supported host lives at https://agentdraft.io/for-agents/mcp.

Related MCP server: Generic MCP Server for Google Workspace

Install

pip install agentdraft-mcp

Requires Python 3.10+ and a valid avs_live_… agent key from the AgentDraft dashboard.

Upgrade

pip install -U agentdraft-mcp

Release notes: https://agentdraft.io/changelog

Configure your MCP client

agentdraft-mcp is on PyPI, so once it's installed the JSON config below works on any MCP host right now — no extra downloads.

Claude Desktop / Claude Code — JSON config (recommended)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on Windows/Linux:

{
  "mcpServers": {
    "agentdraft": {
      "command": "agentdraft-mcp",
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

Cursor / Cline / generic stdio host

{
  "mcpServers": {
    "agentdraft": {
      "command": "python",
      "args": ["-m", "agentdraft_mcp"],
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

For local development against a dev backend, also set AGENTDRAFT_BASE_URL=http://localhost:8080.

Claude Desktop — .mcpb Desktop Extension (drag-drop)

Each release also ships a .mcpb Desktop Extension bundle on GitHub Releases. Drag agentdraft-mcp.mcpb into Claude Desktop → Settings → Extensions and paste your avs_live_… API key — no JSON editing, no pip install.

Tools

All times are ISO 8601 strings (2026-06-01T14:00:00Z). All write tools accept an idempotency_key for safe retries. create_hold and commit_booking also accept an optional title and invitee ({name, email, notes}) recording who the slot is for — surfaced to the owner in the dashboard.

How conflicts surface

When two agents race for the same slot, exactly one wins. Losing agents receive a structured outranked payload — not a string error:

{
  "error": "outranked",
  "winning_booking_id": "bkg_…",
  "winning_agent_id": "agt_…",
  "winning_agent_priority": 1,
  "your_priority": 3,
  "message": "Your booking was outranked. Read winning_agent_id and propose an alternate slot rather than retrying."
}

Your agent should branch on this and propose an alternate, not retry the same slot.

How this differs from the AgentDraft SDKs

Use the SDK when you are writing the agent. Use this MCP server when someone else's agent runtime (Claude Desktop, Cursor, Cline, generic MCP host) needs to call AgentDraft on a user's behalf without custom code.

Links

• Protocol spec: https://agentdraft.io/spec

• API docs: https://agentdraft.io/docs

• Changelog: https://agentdraft.io/changelog

• Python SDK: agentdraft

• TypeScript SDK: agentdraft

• Source: https://github.com/ryabinski-labs/agentdraft-mcp

• Issues: https://github.com/ryabinski-labs/agentdraft-mcp/issues

Security

Found a vulnerability? See SECURITY.md. Do not open a public issue for a security report.

Contributing

See CONTRIBUTING.md. ryabinski-labs/agentdraft-mcp is a published mirror of a directory in AgentDraft's private application repository — issues and pull requests are read there, and land back through the next release sync.

License

MIT — see LICENSE.