English Français العربية

com.formpaste/formpaste

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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 (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "formpaste": {
            "command": "npx",
            "args": [
                "-y",
                "formpaste-mcp@1.0.1"
            ],
            "env": {
                "FORMPASTE_TOKEN": "<your formpaste_token>"
            }
        }
    }
}

متغيرات البيئة

  • 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو com.formpaste/formpaste؟

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

كيف أثبّت com.formpaste/formpaste؟

يعمل كخادم بعيد. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.formpaste/formpaste إلى مفتاح API؟

نعم. يتطلب FORMPASTE_TOKEN, Authorization، وتضبطها في إعداداته.

هل com.formpaste/formpaste مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.formpaste/formpaste؟

ينشره webrating. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.