---
name: reachpad
description: Connect reachpad to your AI agent, then read, publish, and edit shared documents over MCP. Use to SET UP reachpad in an MCP client (Claude Code, Cursor, VS Code, Claude Desktop) and to hand a markdown/HTML doc to a person or another agent at one stable link. Every doc is versioned with a tamper-evident history.
homepage: https://reachpad.dev
mcp: https://reachpad.dev/mcp
reference: https://reachpad.dev/llms.txt
---

# reachpad

reachpad gives every document one stable URL — a rendered page for a person, raw markdown for an
agent. Connect it to your agent once, then publish, read, and edit docs over MCP (or plain HTTP).
Reading public/unlisted docs is open; publishing/editing needs a token (step 2). Every change is
versioned in a tamper-evident, hash-chained history.

## 1. Connect reachpad to your agent
The MCP endpoint is https://reachpad.dev/mcp. Pick your client:

Claude Code — run:
      claude mcp add --transport http --header "Authorization: Bearer <YOUR_TOKEN>" reach https://reachpad.dev/mcp

Cursor — add to ~/.cursor/mcp.json:
      {
        "mcpServers": {
          "reach": {
            "url": "https://reachpad.dev/mcp",
            "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
          }
        }
      }

VS Code (Copilot) — run:
      code --add-mcp '{"name":"reach","type":"http","url":"https://reachpad.dev/mcp","headers":{"Authorization":"Bearer <YOUR_TOKEN>"}}'

Claude Desktop / any MCP client — add to its config:
      {
        "mcpServers": {
          "reach": {
            "type": "http",
            "url": "https://reachpad.dev/mcp",
            "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
          }
        }
      }

Stdio-only client: npx -y @reachpad/mcp   (env: REACH_BASE_URL=https://reachpad.dev, REACH_SERVICE_TOKEN, REACH_ACTOR)
One-click install buttons for Cursor / VS Code: https://reachpad.dev/connect

## 2. Get your token  (needed to publish/edit; reading is open)
Sign in at https://reachpad.dev/my and mint an agent token — account-bound, revocable, shown once. Paste it in
place of <YOUR_TOKEN> above. Reading public/unlisted docs needs no token, so just drop the header.

## 3. Verify it works
Ask your agent to read any reachpad doc — e.g. the MCP tool get_doc on a https://reachpad.dev/d/<slug> link, or:
      curl -s https://reachpad.dev/d/<slug>?raw=1

## What you can do now (MCP tools)
- Publish: create_doc -> returns a shareable URL. Hand that link to a person or another agent.
- Read: get_doc (raw source, safe to edit and round-trip), get_doc_meta, get_history, get_diff.
- Edit: edit_doc (whole doc) or edit_section (one heading; safe for concurrent edits to other sections).
- Comment: add_comment / list_comments (advisory review notes; not part of the history).
- Multi-file trees with per-file sharing (a "space" / org): create_org, create_file, read_file,
  write_file, edit_file_section, share_file (by email), set_file_link (opt-in link), list_files.

## Prefer plain HTTP? (same operations, no MCP)
      # read (open):  curl -s https://reachpad.dev/d/<slug>?raw=1
      # publish:      curl -s -X POST https://reachpad.dev/docs \
                        -H 'Authorization: Bearer <YOUR_TOKEN>' \
                        -H 'Content-Type: text/markdown' -H 'X-Reach-Actor: my-agent' --data-binary @doc.md
      # edit:         PUT https://reachpad.dev/d/<slug>  with If-Match: <version>  (409 on a version conflict)
Write credential: Authorization: Bearer <YOUR_TOKEN> (the account token you minted at https://reachpad.dev/my). A bare X-Reach-Owner-Key does NOT create here.

## Conventions that matter
- Always send X-Reach-Actor: <your-id> (or the MCP actor) so your edits are attributed in the history.
- Visibility defaults to UNLISTED (reachable by link, not search-indexed); pass public to allow indexing.
- Tokens ride in headers only (the MCP config / Authorization: Bearer), NEVER in the URL.

Full HTTP reference: https://reachpad.dev/llms.txt · OpenAPI: https://reachpad.dev/openapi.json · Contact: seiji@intencion.io