# 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://agentdrive.nanocorp.app/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://agentdrive.nanocorp.app/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://agentdrive.nanocorp.app/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://agentdrive.nanocorp.app/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://agentdrive.nanocorp.app/.well-known/oauth-protected-resource/mcp
https://agentdrive.nanocorp.app/.well-known/oauth-authorization-server

Claude Code:
claude mcp add --transport http agentdrive https://agentdrive.nanocorp.app/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.

Codex:
codex mcp add agentdrive --url https://agentdrive.nanocorp.app/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://agentdrive.nanocorp.app/mcp"}}}
Put it in .cursor/mcp.json. Cursor app: Settings, MCP, connect agentdrive.
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://agentdrive.nanocorp.app/mcp
Custom connectors require a supported Claude plan.
Local bridge alternative:
{"mcpServers":{"agentdrive":{"command":"npx","args":["-y","mcp-remote","https://agentdrive.nanocorp.app/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.
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