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.
ปุ่ม Claude ด้านบนจะเปิด Claude พร้อมกรอกชื่อและ URL ให้แล้ว คุณยังต้องยืนยันที่นั่นเอง
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 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.
Create and wire up contact forms from your coding agent. Forms, snippets, and submissions.
API key
FORMPASTE_TOKEN
ตรวจสอบล่าสุด
2026-10-23
ดาว
—
เครื่องมือ
6
อัปไทม์
—
mcp-remote
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.
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:
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.
Create a Formpaste form and return its access key + a wired snippet. Triggers destination verification for a new address (the owner completes it in the dashboard); an already-verified destination delivers immediately. Errors with: unauthorized, upgrade_required.
Return a copy-paste form snippet for a framework (html, react, nextjs, astro, vue, svelte). Pass formId to fill in a real access key; otherwise a placeholder is used. Errors with: unauthorized, invalid_framework.
List submissions for one of your forms. Returns counts + per-submission metadata by default; set includeContent to include message bodies (third-party PII). Errors with: unauthorized, not_found, forbidden. Requires a full-access token.
List all forms on your account, each with its id, name, access_key, and inbox/spam counts. Use this to discover form ids or confirm a form you just created exists. Errors with: unauthorized.
Read one of your forms to verify it is wired correctly: returns its access_key, destination_email, destination_verified (whether submissions will be emailed yet), allowed_domains, and notification/autoresponder/webhook config. Never returns the webhook signing secret. Errors with: unauthorized, not_
Store a TEST submission so you can prove a form is live and receiving. Stored only: it appears in the owner's Inbox with a Test badge but sends NO email, runs NO spam scoring, and never counts toward quota. Optionally pass sample fields; omit to use a default payload. Capped at the 5 newest test row