AgentDrive
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Open source Repository Open in the app JSON README (API)
About
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- sh.agentdrive
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-04T12:39:14Z
- Repository state
- ativo
- Language
- TypeScript
- License
- Apache-2.0
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
sh.agentdrive/agentdrive
README
# AgentDrive MCP Server
The official [Model Context Protocol](https://modelcontextprotocol.io) server for
**[AgentDrive](https://agentdrive.sh)** — 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`](https://www.npmjs.com/package/@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](https://smithery.ai/servers/rakesh1002/agentdrive)**.
### 2. Local (stdio) — via npx
```jsonc
{
"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:
```sh
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
```sh
npm install
npm run build # tsc -> dist/
npm test # vitest
```
## License
Apache-2.0. See [LICENSE](./LICENSE).