AgentDrive MCP Server

The official Model Context Protocol server for AgentDrive — a cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, LangGraph, and any MCP-aware host.

Give your agents a shared, persistent workspace: files with versioning, semantic recall over everything prior agents produced, run logging, and cross-agent attribution — so the next session (on any tool) picks up where the last one left off.

• Website: https://agentdrive.sh
• Docs: https://agentdrive.sh/docs
• npm: @adrive/mcp-server
• Hosted endpoint: https://mcp.agentdrive.sh/mcp

Get an API key (free)

Create one at https://app.agentdrive.sh — no credit card. The free tier (1 workspace, 1 GB storage, 10k embeddings) is free indefinitely.

Two ways to connect

1. Hosted (no install) — Streamable HTTP

Point any MCP client that supports remote servers at the hosted endpoint and pass your key as a bearer token:

URL:    https://mcp.agentdrive.sh/mcp
Header: Authorization: Bearer agentdrive_live_xxx

Or install in one click via Smithery.

2. Local (stdio) — via npx

{
  "mcpServers": {
    "agentdrive": {
      "command": "npx",
      "args": ["-y", "@adrive/mcp-server"],
      "env": {
        "AGENTDRIVE_API_KEY": "agentdrive_live_xxx"
      }
    }
  }
}

Add that block to your host's MCP config:

• Claude Desktop: claude_desktop_config.json
• Cursor: ~/.cursor/mcp.json
• Claude Code: claude mcp add agentdrive -- npx -y @adrive/mcp-server (set AGENTDRIVE_API_KEY in env)
• Codex / Cline / Continue / Zed: the standard mcpServers block above

The fastest path is the AgentDrive installer, which auto-wires every detected host:

curl -fsSL agentdrive.sh/install | sh

Configuration

Env var	Required	Default	Description
AGENTDRIVE_API_KEY	yes	—	Your AgentDrive API key (agentdrive_live_...).
AGENTDRIVE_API_URL	no	https://app.agentdrive.sh	Override the API endpoint (self-hosted worker).
AGENTDRIVE_AGENT_PLATFORM	no	claude-code	Which agent runtime is calling — drives cross-agent provenance. One of claude-code, codex, cursor, langgraph, crewai, autogen, cline, continue, zed, unknown.
AGENTDRIVE_AGENT_ROLE	no	—	Free-text role label (e.g. planner, reviewer) to distinguish multiple agents on the same platform.

Tools

20 tools across files, memory, collaboration, org, and provenance.

Tool	Category	Description
drive_context	memory	Auto-pull the most relevant prior artifacts for the task you're starting.
drive_search	memory	Semantic search across your org's artifacts.
drive_recall	memory	Recall persistent facts/preferences agents have written.
drive_write	files	Write a markdown file (auto-versioned).
drive_read	files	Read a file's content.
drive_list	files	List files in a workspace.
drive_delete	files	Delete a file.
drive_versions	files	View a file's version history.
drive_share	collaboration	Generate a (optionally email-gated) share link.
drive_comment	collaboration	Comment on a file.
drive_feedback	collaboration	Read human comments on a file.
drive_activity	provenance	Recent workspace activity (writes, comments, shares).
drive_log_run	provenance	Log an agent run (task, status, artifacts, identity).
drive_invite	org	Invite a human to your org by email.
drive_roles	org	Assign/list/remove per-workspace access by email.
drive_org	org	View org details: agents, members, plan, usage.
drive_sandbox_clone	sandbox (experimental)	Clone a git repo into a per-workspace Linux sandbox.
drive_sandbox_exec	sandbox (experimental)	Run a shell command in the sandbox.
drive_sandbox_read	sandbox (experimental)	Read a file from the sandbox filesystem.
drive_sandbox_commit	sandbox (experimental)	Stage + commit the sandbox worktree.

The drive_sandbox_* tools require the Cloudflare Containers plan on the AgentDrive worker and degrade cleanly to a "not configured" message otherwise.

Why AgentDrive

Agents lose context at every session boundary and every tool switch. AgentDrive is the shared substrate: one workspace, every agent, full provenance. Write once with Claude Code; recall it from Cursor; hand off to Codex — each call is attributed to the right principal and platform.

Develop

npm install
npm run build      # tsc -> dist/
npm test           # vitest

License

Apache-2.0. See LICENSE.