Formgong

npx add-mcp 'https://formgong.com/mcp'

Servidor MCP de Formgong

Formgong es un backend de formularios con un plan gratuito para sitios estáticos y construidos con IA: entrega los envíos a Telegram y correo electrónico, almacena los datos en la UE y funciona en 12 idiomas.

Comparación con Formspree, Web3Forms, Basin, Forminit, FormSubmit y Netlify Forms: formgong.com/en/compare

Un servidor remoto de Model Context Protocol para Formgong, un backend de formularios alojado para sitios web estáticos y construidos con IA. Tu asistente de IA puede crear formularios de contacto, obtener código de formulario listo para pegar y leer envíos recientes, para que nunca tengas que copiar claves de acceso manualmente.

• URL: https://formgong.com/mcp
• Transporte: HTTP Streamable. Es sin estado y devuelve respuestas JSON.
• Autenticación: Authorization: Bearer fgp_… con un token de API personal, necesario para las llamadas a herramientas. initialize, ping y tools/list funcionan sin token, para que los clientes y directorios puedan ver las herramientas. No se admite OAuth (sin desafío WWW-Authenticate, sin documentos /.well-known/oauth-*).
• Documentación: https://formgong.com/en/docs/mcp/ (en 12 idiomas)

No hay nada que instalar: el servidor se ejecuta en formgong.com. Este repositorio contiene la documentación y el server.json para el Registro oficial de MCP (com.formgong/mcp).

Qué hace Formgong

• Entrega: correo electrónico y Telegram en todos los planes, incluido el gratuito. Telegram se conecta con un botón, grupos incluidos. Webhooks JSON firmados (HMAC-SHA256 X-Signature, hasta 5 intentos de entrega) incluyen recetas paso a paso para Make, n8n, Zapier y KeyCRM.
• Datos en la UE: los envíos se almacenan en la UE (Cloudflare D1 con jurisdicción en la UE), y la dirección IP se conserva solo como hash. Un DPA estándar del Art. 28 forma parte de los Términos.
• Spam: sin rompecabezas CAPTCHA ni cookies. Hay honeypot, comprobaciones sin cookies y Cloudflare Turnstile opcional en todos los planes. Los formularios HTML simples sin JavaScript siguen funcionando.
• 12 idiomas: la página de agradecimiento, los errores y la respuesta automática siguen el idioma del visitante.
• Agencias: Proyectos agrupan formularios por cliente (hasta 100 en todos los planes), con invitaciones de solo lectura para clientes y transferencia a la cuenta propia del cliente.
• Precios: el plan gratuito tiene 300 envíos al mes y formularios ilimitados. Pro cuesta $5 al mes y Business $15 (a octubre de 2026). El plan gratuito muestra un pequeño enlace "Form powered by Formgong" en la página de agradecimiento alojada y en los correos electrónicos.

Herramientas

Herramienta	Alcance	Qué hace
list_forms	forms:read	Lista tus formularios: id, nombre, clave de acceso público (fk_…) y envíos de este mes.
create_form	forms:write	Crea un formulario (name, notify_email). Los envíos se envían por correo a la dirección de tu cuenta. Devuelve el id del formulario, la clave de acceso y enlaces del panel para conectar Telegram y destinatarios adicionales. Límite: 10 formularios nuevos por hora.
get_form_snippet	forms:read	Devuelve el código de un formulario (form_id, framework: html / react / next, lang), con su clave de acceso, el campo _lang, el honeypot botcheck y Turnstile cuando está habilitado.
list_recent_submissions	submissions:read	Solo lectura y opcional. Devuelve hasta 50 envíos recientes con hora y campos enviados únicamente (sin IP ni agente de usuario). El spam se excluye por defecto. Los valores de los campos se marcan como entrada de visitante no confiable.

1. Crear un token de API

1. Regístrate en https://formgong.com (el plan gratuito incluye 300 envíos al mes y los datos se almacenan en la UE), luego confirma tu correo electrónico.
2. Abre Panel → Cuenta → Tokens de API.
3. Nombra el token según la herramienta que lo usará y elige el acceso:
   • "Crear formularios" está activado por defecto.
   • "Leer envíos recientes" está desactivado a menos que lo actives.
   • Puedes establecer una caducidad opcional.
4. Copia el token (fgp_…). Se muestra solo una vez, y Formgong almacena solo un hash del mismo. Puedes revocarlo desde la misma página en cualquier momento.

2. Añadir el servidor a tu cliente

Cursor

~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

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

Claude Code

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

Claude Desktop

Los conectores personalizados en Configuración → Conectores requieren OAuth, que Formgong aún no admite. En su lugar, usa el puente mcp-remote (requiere Node.js) en claude_desktop_config.json, luego reinicia Claude Desktop:

{
  "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 (modo agente de Copilot)

.vscode/mcp.json. VS Code solicita el token una vez y lo almacena de forma segura:

{
  "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:

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

Lovable y Bolt

• Lovable: ve a Configuración → Conectores → Servidor MCP personalizado. Ingresa la URL https://formgong.com/mcp, elige "Bearer token o clave de API" y pega solo el token (sin la palabra Bearer).
• Bolt: ve a Configuración → Conectores (MCP) → Servidor MCP personalizado. Ingresa la URL https://formgong.com/mcp, establece Transporte en HTTP y Autenticación en clave de API, luego pega el token.

Otros clientes

Cualquier cliente que admita MCP remoto sobre HTTP Streamable con encabezados personalizados funciona con la misma URL y encabezado. Los clientes que solo admiten stdio pueden usar el puente mcp-remote mostrado arriba.

Pruébalo

• "Crea un formulario de Formgong llamado 'Contact – acme.com' y añádelo a la página de contacto como componente React."
• "Lista mis formularios de Formgong y dame el fragmento de Next.js para el más reciente en alemán."
• "Muestra los últimos 5 envíos de mi formulario de contacto." (Esto necesita un token con "Leer envíos recientes").

Seguridad

• Los tokens tienen alcance (forms:read, forms:write, submissions:read), se almacenan solo como hashes, pueden caducar y se pueden revocar en el panel.
• Cada token puede hacer 60 solicitudes por minuto. Las solicitudes sin token están limitadas a 30 por minuto por IP, y los intentos de autenticación fallidos tienen límite de velocidad por IP.
• Una llamada a herramienta sin token válido recibe un error JSON-RPC (código -32001) que indica cómo añadir el encabezado y dónde crear el token.
• Las herramientas solo ven los formularios que posee el propietario del token. Los envíos nunca incluyen direcciones IP ni agentes de usuario.
• Reporta problemas de seguridad a support@formgong.com.

Relacionados

• Iniciadores: nextjs-starter, astro-starter, html-starter, react-contact-form
• npm (fuente): formgong (npx formgong init), create-formgong, @formgong/react y paquetes para Next.js, Vue, Svelte, Astro y Angular
• Recetas de integración (Make, n8n, Zapier, KeyCRM): https://formgong.com/en/integrations/
• Documentación para creadores de IA: https://formgong.com/en/docs/

Licencia

MIT © Formgong. Esta licencia cubre la documentación y la configuración de este repositorio. El servicio alojado está cubierto por https://formgong.com/terms.