Caipi docs

Connect your agent

Caipi is a remote MCP server. Point any MCP-capable client at the server URL below. The first connection opens a Google sign-in: use the same account you created your workspace with.

Claude

In Claude Desktop or claude.ai (paid plans), open Settings → Connectors → Add custom connector and paste the server URL above. In the Claude Code CLI, run this once:

ChatGPT

On a paid plan, open Settings → Connectors → Create and paste the server URL above.

Cursor

Open Settings → MCP → Add new MCP server and paste the server URL above.

Any other MCP client

Add Caipi as a remote MCP server over streamable HTTP using the URL https://caipi.ai/mcp. Authorization runs over OAuth in your browser the first time you connect.

What your agent can do

Once connected, your agent has ten tools, grouped into reading and writing. All paths are workspace-relative (like notes/todo.md), never local filesystem paths.

Read

• read_file — read a text file or image, or fetch metadata only.
• find_files — list or search the workspace by path and text; returns up to 50 files.
• query_sql — run one read-only SQLite statement (SELECT or PRAGMA) against a .sqlite file.
• get_upload_status — check a browser upload link and see which files arrived.

Write

• write_file — create or overwrite a text file (.md, .html, .js, .css, .json, .sql).
• execute_sql — run SQLite write statements (DDL and DML) against a .sqlite file.
• delete_file — delete a file.
• move_file — move or rename a file.
• request_upload — create a short-lived browser link so you can hand off files from your device.
• set_visibility — set a file or folder to private, public, or password-protected.

There is also a build_app prompt: invoke it for the full, copy-pasteable guide to building a SQLite-backed app.

The workspace model

A workspace is a tree of plain files. Markdown and HTML files render as pages; a folder serves its index.html or index.md like a small web server. SQLite databases get a read-only table browser. Uploads (PDFs, images, archives) sit alongside the rest.

Every file or folder has one of three visibility tiers: private (owner only, the default), public (reachable by anyone), or password-protected (a browser prompt gates access). A folder rule cascades to everything inside it.

Published content is served from a separate content origin, share.caipi.ai, so shared pages and apps run isolated from your authenticated session on the main site.

Building apps

A Caipi app is a folder with an index.html and a manifest.json. The manifest declares named SQL operations; the page calls them with a plain fetch to ./api/{op}, and Caipi runs the SQL server-side. The browser never sends raw SQL, so a public app exposes only the operations you declare. Apps follow normal file visibility, private by default. For the complete, copy-pasteable recipe, invoke the build_app prompt from your agent.

Limits

The free tier includes 250 MCP tool calls per week (the counter resets Monday at 00:00 UTC) and 50 MB of workspace storage. Pro is coming soon.

FAQ & troubleshooting

My agent can't connect.

Confirm the server URL is exactly https://caipi.ai/mcp and that your client supports remote MCP over HTTP. The first connection must complete the Google sign-in in your browser; sign in with the account that owns the workspace. You can review and revoke connected agents anytime under Settings in your workspace.

Where did my file go? How do I find content?

Everything lives in your workspace at caipi.ai/{username}. Browse the folder tree there, or ask your agent to run find_files to list or search by name and text.

How do I make something public?

Ask your agent to call set_visibility on the file or folder, or use the publish control in the workspace UI. Public content is served from share.caipi.ai.

How do I delete my account or data?

Open Settings in your workspace to export a zip of your files or delete your account. See the privacy policy for what deletion covers and how to make a request by email.

Your data

Your files live in your workspace on Caipi's hosting and stay private unless you publish them. You can export everything as open-format files from Settings, and delete your account and workspace from the same place. For details on what we store, retention, and how to make a request, see the privacy policy.