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.