AgentDrive

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "AgentDrive": {
      "url": "https://mcp.agentdrive.sh/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• drive_write

  Write a markdown file to a workspace. Creates or updates the file with automatic versioning.

  Parameters:

  • workspace_id (required) — string — Workspace ID to write to
  • path (required) — string — File path (e.g. "notes/meeting.md")
  • content (required) — string — File content (markdown)
  • message — string — Optional version message

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_read

  Read a file's content from a workspace.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • file_id (required) — string — File ID to read

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_list

  List files in a workspace, optionally filtered by path prefix.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • prefix — string — Path prefix filter (e.g. "notes/")

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_share

  Generate a share link for a workspace or specific file. Optionally email-gate the link so only a specific person can access it. Humans open this link to view, comment, or edit files.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • permission (required) — string — Permission level for the share link
  • email — string — Email-gate: only this email can access the link (requires email verification). Leave empty for public access.
  • file_id — string — Scope to a specific file (optional)
  • max_uses — number — Maximum number of uses (optional)
  • expires_in — number — Expiry in seconds (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_comment

  Add a comment to a file.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • file_id (required) — string — File ID to comment on
  • body (required) — string — Comment text
  • line_end — number — End line number (optional)
  • line_start — number — Start line number (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_feedback

  Read human comments on a file. Use this to check if humans have left feedback.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • file_id (required) — string — File ID to read comments from

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_activity

  Get recent activity in a workspace (file writes, comments, shares).

  Parameters:

  • workspace_id (required) — string — Workspace ID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_invite

  Invite a human to your organization by email. They will receive a verification code to join.

  Parameters:

  • email (required) — string — Email address of the human to invite to your organization
  • role — string — Role in the organization (default: member)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_roles

  Manage per-workspace role delegation. Assign, list, or remove access for specific emails (view/comment/edit).

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • action (required) — string — Action: assign a role, list all roles, or remove a role
  • email — string — Email address (required for assign/remove)
  • permission — string — Permission level (required for assign)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_org

  View your organization details: agents, members, plan, and usage.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_delete

  Delete a file from a workspace.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • file_id (required) — string — File ID to delete

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_versions

  View version history for a file in a workspace.

  Parameters:

  • workspace_id (required) — string — Workspace ID
  • file_id (required) — string — File ID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_search

  Semantic search across your org's artifacts in AgentDrive. Returns the top-N most relevant files. Use this BEFORE writing similar artifacts to avoid duplication and surface prior context.

  Parameters:

  • query (required) — string — Search query
  • top_k — integer — Max hits to return (default 10, max 50)
  • filter — object
  • workspace_id — string — Scope to a single workspace; omit for org-wide search

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_recall

  Recall persistent facts and preferences your agents have written. In v1 this returns semantic search results across artifacts; v1.5 will narrow to auto-extracted facts (preferences, decisions, key entities).

  Parameters:

  • query (required) — string — Recall query — what fact, preference, or decision are you trying to remember?
  • top_k — integer — Max results (default 5, max 20)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_log_run

  Log an agent run to AgentDrive's provenance store. Captures task, status, referenced/produced artifacts, and cross-platform identity (which agent on which tool). Used for retrospective context retrieval and team-wide audit.

  Parameters:

  • task (required) — string — What the agent did or is doing (free text)
  • run_id — string — Existing run ID to update; omit to let server allocate
  • status — string — Run outcome (default success)
  • metadata — object — Free-form key/value metadata
  • duration_ms — integer — Wall-clock duration in milliseconds
  • artifacts_produced — array — Paths of artifacts the run wrote
  • artifacts_referenced — array — Paths of artifacts the run read

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_context

  Auto-pull the most relevant artifacts from prior agent sessions for the task you are about to do. Combines semantic relevance with recency. Call this at the START of any non-trivial task to ground the agent in prior context — replaces manual copy-paste of artifacts between sessions.

  Parameters:

  • task (required) — string — What you are about to do — used to rank prior artifacts by relevance
  • limit — integer — Max artifacts to return (default 5, max 20)
  • workspace_id — string — Scope to a single workspace; omit for org-wide context

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_sessions

  List recent agent sessions for this project across harnesses (Claude Code, Codex, OpenCode, Gemini CLI, Cursor), newest first. Use to find prior work to continue.

  Parameters:

  • limit — integer — Max sessions to return (default 10, max 50)
  • project — string — Project key; defaults to the project of the current working directory
  • platform — string — Only sessions from this harness (claude-code, codex, opencode, gemini-cli, cursor)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_resume

  Load a compact handoff brief (goal, files touched, recent turns) from a prior session, by default the latest one from a different harness, so you can continue that work.

  Parameters:

  • platform — string — When session_id is omitted, only consider sessions from this harness
  • max_chars — integer — Handoff size budget in characters (default 12000)
  • session_id — string — Session run id from drive_sessions (e.g. codex:abc123); omit to pick the latest session from another harness

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_sandbox_clone

  [EXPERIMENTAL] Clone a git repo into a per-workspace Linux sandbox. Requires Cloudflare Containers on the AgentDrive worker; gracefully degrades to a 503 with "sandbox not configured" otherwise.

  Parameters:

  • workspace_id (required) — string — Workspace to clone into. The sandbox persists across MCP sessions per workspace.
  • url (required) — string — Git repository URL to clone
  • depth — integer — Shallow clone depth (default: full clone)
  • branch — string — Branch to check out (default: repo default)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_sandbox_exec

  [EXPERIMENTAL] Run a shell command inside the per-workspace Linux sandbox. Captures stdout/stderr (64 KB cap), exit code, duration. Requires Cloudflare Containers; degrades to 503 otherwise.

  Parameters:

  • workspace_id (required) — string — Workspace whose sandbox to run in
  • cmd (required) — string — Shell command to run inside the per-workspace Linux sandbox
  • cwd — string — Working directory (default: workspace root)
  • timeout_ms — integer — Max runtime in ms (default 30000, hard cap 60000)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_sandbox_read

  [EXPERIMENTAL] Read a file from the per-workspace sandbox filesystem (build artifacts, test output, logs). Requires Cloudflare Containers; degrades to 503 otherwise.

  Parameters:

  • workspace_id (required) — string — Workspace whose sandbox to read from
  • path (required) — string — Path inside the sandbox (e.g., src/index.ts or /tmp/build.log)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• drive_sandbox_commit

  [EXPERIMENTAL] Stage + commit the current sandbox worktree. Surfaces as an AgentDrive artifact at commits/<sha>.json. Requires Cloudflare Containers; degrades to 503 otherwise.

  Parameters:

  • workspace_id (required) — string — Workspace whose sandbox to commit
  • message (required) — string — Commit message
  • author_name — string — Override git author name (default: agent identity)
  • author_email — string — Override git author email (default: agent identity)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.