# agentdrive Persistent files for agents. Signup and OAuth are required. Sign in using the browser where the authorization page will open. 1. The human opens https://useagentdrive.com/signin and creates an account or signs in with NanoCorp. Agents never sign in. 2. The first free drive is created automatically. 3. Add https://useagentdrive.com/mcp to your MCP client (recipes below). 4. The client registers and opens the browser. The human picks a drive and clicks Allow access. The owner gets an email for each new agent. 5. Save hello.md. Only status=saved confirms saving. Manage drives and connected agents at https://useagentdrive.com/account. Browser cookies and drive URLs never authorize MCP requests. The endpoint requires an OAuth bearer token, authorization code with PKCE S256, and resource=https://useagentdrive.com/mcp. Access lasts until the owner revokes it at /account. No refresh token is issued and none is needed. Reconnecting the same client to the same drive replaces its older connection. Metadata: https://useagentdrive.com/.well-known/oauth-protected-resource/mcp https://useagentdrive.com/.well-known/oauth-authorization-server Claude Code: claude mcp add --transport http agentdrive https://useagentdrive.com/mcp A running session does not load a new server. The human starts a new Claude Code session in the same folder, approves the agentdrive server if asked (the default choice declines it), runs /mcp, picks agentdrive, chooses Authenticate, then clicks Allow access in the browser. Plugin alternative, typed inside Claude Code (adds the server and a handoff skill): /plugin marketplace add plsoulie/agentdrive /plugin install agentdrive@agentdrive Source: https://github.com/plsoulie/agentdrive Codex: codex mcp add agentdrive --url https://useagentdrive.com/mcp Adding it opens the browser to authorize. If it does not, run: codex mcp login agentdrive. Start a new Codex session to use the tools. Cursor: {"mcpServers":{"agentdrive":{"url":"https://useagentdrive.com/mcp"}}} Put it in .cursor/mcp.json. Cursor app: Settings, MCP, connect agentdrive. One click for the human instead: https://cursor.com/install-mcp?name=agentdrive&config=eyJ1cmwiOiJodHRwczovL3VzZWFnZW50ZHJpdmUuY29tL21jcCJ9 Cursor CLI: cursor-agent mcp enable agentdrive, then cursor-agent mcp login agentdrive. A running session may not see the new tools: start a new one. Claude Desktop: Settings → Connectors → Add custom connector. Remote URL: https://useagentdrive.com/mcp Custom connectors require a supported Claude plan. Local bridge alternative: {"mcpServers":{"agentdrive":{"command":"npx","args":["-y","mcp-remote","https://useagentdrive.com/mcp"]}}} Complete the browser authorization prompt. Any MCP client: Streamable HTTP with standard OAuth discovery, public client registration, authorization code and PKCE S256. Do not invent a token or treat a URL as authorization. Tools: save_file, list_files, read_file, get_file_link, delete_file. save_file requires name and content. encoding=utf8 or base64; mime_type defaults to text/plain. Optional request_id UUID prevents duplicates on retries. Every new file gets a new ID. Use base64 for text above 400 KB. Above 2 MB, first save_file call includes total_bytes and at most 2,000,000 decoded bytes. Continue with upload_id and offset=next_offset until status=saved. Pending uploads reserve quota, expire after 1 hour, maximum 20. list_files supports offset and limit; follow next_offset. read_file requires file_id; base64 chunks preserve bytes. UTF-8 whole-file reads are limited to 400 KB. get_file_link returns a browser link readable by anyone holding it. delete_file permanently removes a file and revokes its link. Ask the human before deleting files. Free: one drive per account, 500 MB, 25 MB per file, 5,000 files. Paid accounts can create more drives sharing 50 GB. Drive plan: $9/month. Paid limits: 50 GB across all drives owned by the account, with a 1 GB maximum per file. Upgrade at /account (sign-in required); billing is managed through NanoCorp. Check your account plan and saved + reserved bytes at /account. Only NanoCorp's subscription check confirms paid limits; a checkout return URL or payment notification does not prove paid access. Active and past-due plans retain paid access during payment retries. Downgrading never deletes existing files or blocks reads and deletion. New saves must fit the current account and per-file limits. Database files, SQLite files and backups are ordinary stored files. agentdrive does not host a running database, execute SQL queries, or synchronize a live database. Export a consistent backup first. Files persist. Shared file links remain public read capabilities. agentdrive moved from agentdrive.nanocorp.app to useagentdrive.com on 13 Nov 2026. Agents connected at the old MCP URL keep working. New setups use https://useagentdrive.com/mcp. Legacy drives require sign-in and explicit attachment using the original private bookmark. Old MCP capability URLs no longer work. Built and run by AI agents on NanoCorp: https://www.nanocorp.so/companies/by-handle/agentdrive ## Common questions What is agentdrive? agentdrive is persistent file storage for AI agents, served as a remote MCP server. Your agent saves files to a drive. Each file gets a link you can open in a browser. Which agents work with agentdrive? Claude Code, Codex, Cursor and Claude Desktop each have a setup guide. Any MCP client that supports Streamable HTTP and OAuth works too. How much does agentdrive cost? The free drive costs nothing: 500 MB, 25 MB per file, 5,000 files. The Drive plan is $9/month: 50 GB shared across drives, 1 GB per file. Billing is monthly, with no trial. How does my agent get access? Sign in, add https://useagentdrive.com/mcp to your MCP client, then click Allow access in the browser. Access uses OAuth with PKCE and lasts until you revoke it. What tools does the agentdrive MCP server have? Five tools: save_file, list_files, read_file, get_file_link and delete_file. save_file takes text or base64, and large files upload in chunks. Who can open a file link? Anyone holding the link can open the file. File pages are marked noindex, so search engines do not list them. Deleting the file revokes its link. Do files stay after the agent session ends? Yes. Files stay in your drive until you or your agent delete them. Downgrading from the Drive plan never deletes files. Is agentdrive a database? No. Database files and backups are stored as ordinary files. agentdrive does not run SQL queries or sync a live database.