formpaste MCP server
✓ VerifiedCreate, manage, and test contact forms and snippets directly through your coding agent.
Also known as webrating/formpaste-mcp, formpaste-mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- 145
- Latest version
- 1.0.0
- Last commit
- Jul 28, 2026
- License
- MIT
What is formpaste MCP?
formpaste is an MCP server. Create, manage, and test contact forms and snippets directly through your coding agent. It exposes 6 tools, such as create_form, get_snippet, list_forms.
Summary generated from the project's README
About formpaste MCP server
Formpaste provides a way for developers to build and manage contact forms through their coding agents. By connecting to a hosted MCP server via the mcp-remote transport, users can handle form creation and snippet management without leaving their development environment. This server works with various clients including Claude Code, Cursor, VS Code, and Claude Desktop.
To use this service, you need a Formpaste account and an API token from your dashboard. The server offers six specific tools to assist with development tasks. These include create_form, get_snippet, list_forms, get_form, send_test_submission, and list_submissions. You can control data access by using different token scopes.
A setup-scoped token allows an agent to perform configuration tasks like creating forms or retrieving snippets for HTML, React, Next.js, Astro, Vue, or Svelte. This scope prevents the agent from reading actual submission content. For full access to submission data and message bodies, a full-scoped token is required.
What you can do with it
- 1Generate frontend code snippetsAsk your agent to provide the necessary code to embed a form into a specific web framework.
- 2Verify form connectivityHave the agent send a dummy entry to ensure the contact form is functioning as expected.
- 3Audit existing form configurationsRequest a list of all active forms to check their names and current inbox or spam counts.
- 4Secure agentic developmentUse a restricted token so the AI can build forms without accessing private user data.
Written from the project's README. Every use case is checked against a quote from it.
How to install formpaste MCP
Formats verified 10 Nov 2026Install formpaste MCP in Claude Code
$ claude mcp add --env FORMPASTE_TOKEN=<YOUR_FORMPASTE_TOKEN> formpaste-mcp -- npx -y formpaste-mcpInstall formpaste MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"formpaste-mcp": {
"command": "npx",
"args": [
"-y",
"formpaste-mcp"
],
"env": {
"FORMPASTE_TOKEN": "<YOUR_FORMPASTE_TOKEN>"
}
}
}
}Install formpaste MCP in VS Code
.vscode/mcp.json
{
"servers": {
"formpaste-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"formpaste-mcp"
],
"env": {
"FORMPASTE_TOKEN": "<YOUR_FORMPASTE_TOKEN>"
}
}
}
}Install formpaste MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"formpaste-mcp": {
"command": "npx",
"args": [
"-y",
"formpaste-mcp"
],
"env": {
"FORMPASTE_TOKEN": "<YOUR_FORMPASTE_TOKEN>"
}
}
}
}Install formpaste MCP in Codex
~/.codex/config.toml
[mcp_servers.formpaste-mcp] command = "npx" args = ["-y", "formpaste-mcp"] [mcp_servers.formpaste-mcp.env] FORMPASTE_TOKEN = "<YOUR_FORMPASTE_TOKEN>"
Install formpaste MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"formpaste-mcp": {
"command": "npx",
"args": [
"-y",
"formpaste-mcp"
],
"env": {
"FORMPASTE_TOKEN": "<YOUR_FORMPASTE_TOKEN>"
}
}
}
}formpaste MCP tools 6
Detected from the READMEcreate_formget_snippetlist_formsget_formsend_test_submissionlist_submissions
| create_form | — | |
| get_snippet | — | |
| list_forms | — | |
| get_form | — | |
| send_test_submission | — | |
| list_submissions | — |
Configuration
FORMPASTE_TOKENRequiredSecretFormpaste 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.
| Name | Description | |
|---|---|---|
| FORMPASTE_TOKEN | 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. | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablewebrating/formpaste-mcp is public and reachablegithub.com/webrating/formpaste-mcp ↗Pass
- Package names this repository as its sourceformpaste-mcp names webrating/formpaste-mcp as sourcenpmjs.com/package/formpaste-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-07-28github.com/webrating/formpaste-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from formpaste-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 319 msPass
README
View on GitHubformpaste-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
| Tool | Purpose | Scope |
|---|---|---|
create_form |
Create a form, return its access key and a wired snippet | setup |
get_snippet |
Return a copy-paste snippet for html/react/nextjs/astro/vue/svelte | setup |
list_forms |
List all forms with ids, names, access keys, inbox/spam counts | setup |
get_form |
Read one form's config to verify it is wired correctly | setup |
send_test_submission |
Store a test submission to prove a form is live | setup |
list_submissions |
List submissions, optionally including message bodies | full |
Token scopes
Formpaste API tokens have two scopes:
fullcan do everything, including reading submission content vialist_submissions.setupcan do everything exceptlist_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.
Links
- Documentation: https://formpaste.com/docs
- MCP server docs: https://formpaste.com/docs/agents/mcp-server
- Install guide: https://formpaste.com/docs/agents/install
- Issues: https://github.com/webrating/formpaste-mcp/issues
formpaste MCP questions
How do I add formpaste MCP to Claude Code?
Run claude mcp add --env FORMPASTE_TOKEN=<YOUR_FORMPASTE_TOKEN> formpaste-mcp -- npx -y formpaste-mcp in your terminal. Add --scope user to make it available in every project.
How do I add formpaste MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does formpaste MCP provide?
It exposes 6 tools, including create_form, get_snippet, list_forms, get_form, send_test_submission.
How can I limit an agent's access to my form data?
You can use a 'setup' scoped token, which allows form creation and verification but prevents the agent from reading third-party submission content.