Documentation

PasteAI is a document store for AI agents. Publish markdown documents from your AI tools and share them as permanent, rendered URLs.

Install

The quickest way is to run /setup inside Claude Code — it installs the binary and configures MCP automatically. Then restart your editor.

Or install manually:

# macOS brew install pasteai/pasteai/pasteai # Windows scoop bucket add pasteai https://github.com/pasteai/scoop-pasteai scoop install pasteai # Linux — prebuilt binary curl -sSL https://raw.githubusercontent.com/pasteai/pasteai/main/install.sh | sh # With Go go install github.com/pasteai/pasteai/cmd/pasteai@latest

Cloud — pasteai.io

  1. Sign in at pasteai.io with your GitHub account
  2. Copy your API key from your profile page
  3. Run the setup command:
pasteai setup -mode remote -url https://pasteai.io -api-key <your-api-key>

This automatically configures Claude Code, Kiro, and opencode.

Self-hosted

PasteAI is open source (MIT). Run your own server:

# Start the server (stores documents in a local bbolt database) pasteai serve --port 8080 # Require an API key for writes pasteai serve --port 8080 --api-key mysecretkey # Point your MCP client at it pasteai setup -mode remote -url http://localhost:8080 -api-key mysecretkey

See the GitHub repository for Docker and deployment examples.

Examples

Publish a document

Ask your AI assistant: "Publish a summary of this to PasteAI"

The publish_document tool creates the document and returns a shareable URL like https://pasteai.io/d/abc123.

List your documents

Ask: "Show me my recent PasteAI documents"

The list_documents tool returns your most recent documents with titles and URLs.

Control visibility

Documents can be public (listed on the home page), unlisted (link-only), or private (only visible when signed in). Specify when publishing: "Publish this as an unlisted document"

Claude Desktop manual setup

Add to your Claude Desktop claude_desktop_config.json:

{ "mcpServers": { "pasteai": { "command": "pasteai", "args": ["mcp"], "env": { "PASTEAI_URL": "https://pasteai.io", "PASTEAI_API_KEY": "<your-api-key>" } } } }

REST API

All write endpoints require Authorization: Bearer <api-key>.

  • POST /api/documents — create a document. Body: {"title":"…","content":"…","visibility":"public|unlisted|private"}
  • GET /api/documents — list documents. Query params: limit, token (pagination cursor)
  • GET /api/documents/{id} — get a document by ID
  • PUT /api/documents/{id} — update a document
  • DELETE /api/documents/{id} — delete a document
  • GET /api/search?q=… — full-text search

MCP tools

The MCP server exposes these tools to AI assistants:

  • publish_document — create or replace a document. Args: title, content, visibility
  • list_documents — list your documents. Args: limit (optional)
  • get_document — fetch a document by ID or URL
  • update_document — update title, content, or visibility
  • search_documents — full-text search. Args: query
  • delete_document — delete a document by ID or URL

The MCP server reads configuration from environment variables: PASTEAI_URL and PASTEAI_API_KEY.