English Français العربية

com.formpaste/formpaste

Official registry Developer tools

Create and wire up contact forms from your coding agent. Forms, snippets, and submissions.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http formpaste 'https://api.formpaste.com/mcp' --header 'Authorization: <Bearer fpat_ token minted in the Formpaste dashboard under Settings -> API & MCP.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "formpaste": {
            "type": "http",
            "url": "https://api.formpaste.com/mcp",
            "headers": {
                "Authorization": "<Bearer fpat_ token minted in the Formpaste dashboard under Settings -> API & MCP.>"
            }
        }
    }
}
NPM package formpaste-mcp
Claude Code 
claude mcp add formpaste -e 'FORMPASTE_TOKEN=<your formpaste_token>' -- npx -y formpaste-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "formpaste": {
            "command": "npx",
            "args": [
                "-y",
                "formpaste-mcp@1.0.1"
            ],
            "env": {
                "FORMPASTE_TOKEN": "<your formpaste_token>"
            }
        }
    }
}

Environment variables

  • FORMPASTE_TOKEN required secret Formpaste API token starting with fpat_, minted in the dashboard under Settings -> API & MCP. Use a setup-scoped token unless the agent needs to read submission content.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. formpaste-mcp
  2. What this is
  3. Requirements
  4. Install
  5. The six tools
  6. Token scopes
  7. Worked example
  8. Links

formpaste-mcp

Create and wire up contact forms from your coding agent. Six tools for forms, snippets, and submissions.

What this is

This package is a thin wrapper that launches mcp-remote pointed at the hosted Formpaste MCP server (https://api.formpaste.com/mcp, streamable-http transport). The equivalent manual mcp-remote config works identically; this package exists mainly so agents and clients can discover and install Formpaste's MCP server by name, not because it does anything the manual config cannot.

Requirements

  • Node.js 18 or later
  • A Formpaste account
  • An API token from Settings -> API & MCP in the Formpaste dashboard

Install

Each client below is configured to talk to the hosted MCP endpoint at https://api.formpaste.com/mcp. Replace fpat_YOUR_TOKEN with a token minted from Settings -> API & MCP.

Claude Code
claude mcp add formpaste --transport http https://api.formpaste.com/mcp \
  --header "Authorization: Bearer fpat_YOUR_TOKEN"
Codex
# ~/.codex/config.toml
[mcp_servers.formpaste]
command = "npx"
args = ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]
Cursor
// .cursor/mcp.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}
Claude Desktop
// claude_desktop_config.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}
VS Code
// .vscode/mcp.json
{
  "servers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}
Any MCP client, via this package
FORMPASTE_TOKEN=fpat_YOUR_TOKEN npx formpaste-mcp

formpaste-mcp reads FORMPASTE_TOKEN from the environment (or a --token flag) and starts mcp-remote against the hosted endpoint for you.

The six tools

ToolPurposeScope
create_formCreate a form, return its access key and a wired snippetsetup
get_snippetReturn a copy-paste snippet for html/react/nextjs/astro/vue/sveltesetup
list_formsList all forms with ids, names, access keys, inbox/spam countssetup
get_formRead one form's config to verify it is wired correctlysetup
send_test_submissionStore a test submission to prove a form is livesetup
list_submissionsList submissions, optionally including message bodiesfull

Token scopes

Formpaste API tokens have two scopes:

  • full can do everything, including reading submission content via list_submissions.
  • setup can do everything except list_submissions, so it never reads third-party submission content.

Use a setup-scoped token for agent use. It covers form creation, snippets, and verifying that a form is wired correctly, without granting access to the data your forms collect.

Worked example

See examples/wire-a-form.md for a full walkthrough: create a form, get a snippet, paste it into a page, send a test submission, and confirm the form is wired correctly.

Frequently asked questions

What is com.formpaste/formpaste?

Create and wire up contact forms from your coding agent. Forms, snippets, and submissions.

How do I install com.formpaste/formpaste?

It runs as a remote server. In Claude Code: claude mcp add --transport http formpaste 'https://api.formpaste.com/mcp' --header 'Authorization: <Bearer fpat_ token minted in the Formpaste dashboard under Settings -> API & MCP.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.formpaste/formpaste need an API key?

Yes. It expects FORMPASTE_TOKEN, Authorization, which you set in its configuration.

Is com.formpaste/formpaste open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.formpaste/formpaste?

It is published by webrating. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.