> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the MCP server

> Connect the Formpaste MCP server to Claude Code, Codex, Cursor, Claude Desktop, VS Code, or any mcp-remote client.

<Info>**Free** - the MCP server is not plan-gated. You need an API token (`fpat_…`) - mint one under **Settings → API & MCP** in the dashboard.</Info>

Formpaste is a **remote** MCP server, so clients connect to it over HTTP via
[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) rather than launching a local
process. Pick your client below. Swap `fpat_YOUR_TOKEN` for your real token in every case.

<Tabs>
  <Tab title="Claude Code">
    Claude Code installs MCP servers from the CLI:

    ```bash theme={null}
    claude mcp add formpaste --transport http https://api.formpaste.com/mcp \
      --header "Authorization: Bearer fpat_YOUR_TOKEN"
    ```

    Verify: run `claude mcp list` - `formpaste` should appear as connected.
  </Tab>

  <Tab title="Codex">
    Add to `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.formpaste]
    command = "npx"
    args = ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
    ```

    Restart Codex after saving.
  </Tab>

  <Tab title="Cursor">
    Add to `.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "formpaste": {
          "command": "npx",
          "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
        }
      }
    }
    ```

    Restart Cursor after saving.
  </Tab>

  <Tab title="Claude Desktop">
    Add to `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "formpaste": {
          "command": "npx",
          "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
        }
      }
    }
    ```

    Restart Claude Desktop after saving.
  </Tab>

  <Tab title="VS Code">
    Add to `.vscode/mcp.json`:

    ```json theme={null}
    {
      "servers": {
        "formpaste": {
          "command": "npx",
          "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
        }
      }
    }
    ```

    Reload VS Code after saving.
  </Tab>

  <Tab title="Any mcp-remote client">
    Any client that supports `mcp-remote` (Windsurf, Zed, Cline, and others) uses the same
    shape. Point it at `https://api.formpaste.com/mcp` with an
    `Authorization: Bearer fpat_YOUR_TOKEN` header:

    ```json theme={null}
    {
      "command": "npx",
      "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
    }
    ```

    Consult your client's docs for where its MCP config file lives.
  </Tab>
</Tabs>

## Verify it connected

Once installed and restarted, your client should list `formpaste` as a connected server
with **six** tools: `create_form`, `get_snippet`, `list_forms`, `get_form`,
`send_test_submission`, and `list_submissions`. If it does not, see
[Troubleshooting](/docs/agents/troubleshooting).

<CardGroup cols={2}>
  <Card title="MCP server" icon="server" href="/docs/agents/mcp-server">
    The endpoint, auth, and the full tool list.
  </Card>

  <Card title="Cookbook prompts" icon="book" href="/docs/agents/cookbook-prompts">
    Prompts that drive create, wire, and verify end to end.
  </Card>
</CardGroup>