@adrive/mcp-server

MCP server for AgentDrive — the cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, and LangGraph. Files, semantic recall, run logging, and cross-platform attribution.

Drop this server into any MCP-compatible client and your agents get a shared filesystem with provenance, semantic search across artifacts written by other agents, and per-run audit. Memory is a feature of the workspace, not the headline.

Install

pnpm dlx @adrive/mcp-server
# or
npx @adrive/mcp-server

Environment variables

| Variable | Required | Default | Notes | |---|---|---|---| | AGENTDRIVE_API_KEY | yes | — | API key from drive init or the dashboard. | | AGENTDRIVE_API_URL | no | https://app.agentdrive.sh | Override for self-host or staging. | | AGENTDRIVE_AGENT_PLATFORM | no | claude-code | Identifies which host is calling. Valid: claude-code | codex | cursor | langgraph | crewai | autogen | hermes | openclaw | unknown. Unknown values downgrade to unknown server-side. | | AGENTDRIVE_AGENT_ROLE | no | (empty) | Free-form role label (planner, reviewer, etc.). Stamped on every request for provenance. |

Client configuration

Claude Code (~/.claude/mcp-servers.json or claude_desktop_config.json)

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

Codex CLI (~/.codex/config.toml or equivalent)

[[mcp_servers]]
name = "agentdrive"
command = "npx"
args = ["-y", "@adrive/mcp-server"]
env = { AGENTDRIVE_API_KEY = "agentdrive_live_...", AGENTDRIVE_AGENT_PLATFORM = "codex" }

Cursor (~/.cursor/mcp.json)

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

Tools (20)

Files

• drive_write — create or update a file with versioning
• drive_read — read a file's content
• drive_list — list files (paginated automatically)
• drive_delete — delete a file

Collaboration

• drive_share — create a share link (optionally email-gated)
• drive_comment — leave a comment on a file
• drive_feedback — read comments on a file

Provenance

• drive_activity — workspace event feed
• drive_versions — file version history

Search and memory

• drive_search — semantic search across artifacts
• drive_recall — recall facts and preferences (narrows to extracted facts in a future release)
• drive_context — auto-pull relevant artifacts for the task you are about to do
• drive_log_run — record an agent run for cross-platform audit

Org

• drive_invite — invite a human teammate
• drive_roles — assign / list / remove per-workspace roles
• drive_org — view org details, agents, members, usage

License

Apache-2.0. See the repo's LICENSING.md for the full package-by-package breakdown.