Formgong

com.formgongv1.0.0更新于 Oct 3, 2026

Create contact forms, get HTML/React/Next.js snippets and read recent submissions on Formgong.

已验证Streamable HTTP可网页运行Developer ToolsProductivity & Workflow

概览

AI 生成的概览

让助手在 Formgong 上创建联系表单、获取 HTML、React 或 Next.js 嵌入代码，并读取最近的表单提交。

功能
这是一个面向 Formgong（为静态网站和 AI 生成网站提供托管表单后端）的远程 MCP 服务器。工具可以列出你的表单及其公开访问密钥和本月提交数，用名称和通知邮箱创建表单，返回可直接粘贴的 HTML、React 或 Next.js 代码（含访问密钥、蜜罐和 Turnstile 设置），并读取最多 50 条最近提交，仅包含时间和提交字段。服务器无状态，返回 JSON 响应。
适用场景
适合在搭建或维护网站时使用：让助手端到端接入联系表单，创建表单、返回嵌入代码，并查看收到的提交，无需手动复制访问密钥。
运行要求
无需安装，服务器以 Streamable HTTP 远程运行在 Formgong 端点上。需要 Formgong 账号和个人 API 令牌（fgp_...），通过 Authorization 头以 Bearer fgp_... 形式发送。令牌权限包括 forms:read、forms:write 和 submissions:read。仅支持 stdio 的客户端需要 mcp-remote 桥接，且需要 Node.js。不支持 OAuth。
安装前请注意
Authorization 头携带的个人 API 令牌只显示一次，应作为密钥保存，泄露后可在控制台撤销。创建表单会向你的账号写入数据，限制为每小时 10 个新表单。读取提交为可选功能，令牌未开启时不可用。提交内容是不可信的访客输入，且不含 IP 地址和用户代理。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Formgong，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://formgong.com/mcp"
    }
  }
}

README

Formgong MCP server

A remote Model Context Protocol server for Formgong, a hosted form backend for static and AI-built websites. Your AI assistant can create contact forms, get ready-to-paste form code and read recent submissions, so you never have to copy access keys by hand.

  • URL: https://formgong.com/mcp
  • Transport: Streamable HTTP. It's stateless and returns JSON responses.
  • Auth: Authorization: Bearer fgp_… with a personal API token. OAuth is not supported yet.
  • Docs: https://formgong.com/en/docs/mcp/ (in 12 languages)

There's nothing to install: the server runs on formgong.com. This repo holds the documentation and the server.json for the official MCP Registry (com.formgong/mcp).

Tools

ToolScopeWhat it does
list_formsforms:readLists your forms: id, name, public access key (fk_…) and submissions this month.
create_formforms:writeCreates a form (name, notify_email). Submissions are emailed to your account address. It returns the form id, the access key and dashboard links for connecting Telegram and extra recipients. Limit: 10 new forms per hour.
get_form_snippetforms:readReturns code for one form (form_id, framework: html / react / next, lang), with its access key, the _lang field, the botcheck honeypot, and Turnstile when it's enabled.
list_recent_submissionssubmissions:readRead-only and opt-in. Returns up to 50 recent submissions with time and submitted fields only (no IP or user agent). Spam is excluded by default. Field values are marked as untrusted visitor input.

1. Create an API token

  1. Sign up at https://formgong.com (the free plan includes 300 submissions a month, and data is stored in the EU), then confirm your email.
  2. Open Dashboard → Account → API tokens.
  3. Name the token after the tool that will use it, and choose the access:
    • "Create forms" is on by default.
    • "Read recent submissions" is off unless you turn it on.
    • You can set an optional expiry.
  4. Copy the token (fgp_…). It's shown only once, and Formgong stores only a hash of it. You can revoke it from the same page at any time.

2. Add the server to your client

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

json
{  "mcpServers": {    "formgong": {      "url": "https://formgong.com/mcp",      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }    }  }}

Claude Code

bash
claude mcp add --transport http formgong https://formgong.com/mcp \  --header "Authorization: Bearer fgp_your_token"

Claude Desktop

Custom connectors in Settings → Connectors require OAuth, which Formgong doesn't support yet. Instead, use the mcp-remote bridge (it requires Node.js) in claude_desktop_config.json, then restart Claude Desktop:

json
{  "mcpServers": {    "formgong": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://formgong.com/mcp", "--header", "Authorization:${FORMGONG_AUTH}"],      "env": { "FORMGONG_AUTH": "Bearer fgp_your_token" }    }  }}

VS Code (Copilot agent mode)

.vscode/mcp.json. VS Code asks for the token once and stores it securely:

json
{  "inputs": [{ "type": "promptString", "id": "formgong-token", "description": "Formgong API token (fgp_…)", "password": true }],  "servers": {    "formgong": {      "type": "http",      "url": "https://formgong.com/mcp",      "headers": { "Authorization": "Bearer ${input:formgong-token}" }    }  }}

Windsurf

~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "formgong": {      "serverUrl": "https://formgong.com/mcp",      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }    }  }}

Lovable and Bolt

  • Lovable: go to Settings → Connectors → Custom MCP server. Enter URL https://formgong.com/mcp, choose "Bearer token or API key", and paste only the token (without the word Bearer).
  • Bolt: go to Settings → Connectors (MCP) → Custom MCP server. Enter URL https://formgong.com/mcp, set Transport to HTTP and Authentication to API key, then paste the token.

Other clients

Any client that supports remote MCP over Streamable HTTP with custom headers works with the same URL and header. Clients that only support stdio can use the mcp-remote bridge shown above.

Try it

  • "Create a Formgong form called 'Contact – acme.com' and add it to the contact page as a React component."
  • "List my Formgong forms and give me the Next.js snippet for the newest one in German."
  • "Show the last 5 submissions of my contact form." (This needs a token with "Read recent submissions".)

Security

  • Tokens are scoped (forms:read, forms:write, submissions:read), stored only as hashes, can expire, and can be revoked in the dashboard.
  • Each token can make 60 requests a minute, and failed authentication attempts are rate-limited per IP.
  • The tools only see forms the token owner owns. Submissions never include IP addresses or user agents.
  • Report security issues to [email protected].

Related

License

MIT © Formgong. This license covers the documentation and config in this repo. The hosted service is covered by https://formgong.com/terms.

来源：README.md，提交 b9b22a0

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 3, 2026