MCP server overview
Formspring ships a Model Context Protocol (MCP) server. Agents like Claude, Cursor, ChatGPT, Windsurf, VS Code (Copilot Chat), Zed, OpenClaw, and Hermes Agent connect to your workspace and call the same actions you'd click in the dashboard.
What's exposed
The server registers 74 tools, 20 resources, and 12 prompts (server version 2.0.0). What your client actually lists depends on your team's plan - paid-only surfaces are omitted from tools/list, resources/list, and prompts/list on Free. See Tools → and Authentication →.
| Surface | Example tools |
|---|---|
| Forms | list_forms, create_form, publish_form, update_form, send_test_autoresponder, … |
| Submissions | list_submissions, update_submission, bulk_submissions, export_submissions, mark_as_spam, … |
| Webhooks | list_webhooks, create_webhook, replay_webhook_delivery, … (Pro and above) |
| Surveys | list_surveys, create_survey, publish_survey, … (Pro and above; separate product from Forms) |
| Funnels | list_funnels, create_funnel, add_screen, set_logic, set_capi_token, … (Pro and above) |
| Links | list_links, create_link, update_link, … (all plans) |
| Automations | list_automations, run_automation, replay_automation_run, … (all plans) |
| Billing (read-only) | get_team, get_plan, get_usage, get_subscription_state |
| AI Insights | get_ai_insights, regenerate_ai_insights (Pro and above) |
| Tokens | list_tokens, create_token, revoke_token |
| Integration reference | get_framework_integration_catalog - 98-stack matrix with snippets + doc links |
Product routing: contact-style forms use create_form; multi-screen surveys use create_survey; lead-gen funnels use create_funnel; branded links use create_link. Do not cross these tools.
Resources (read-only URIs such as formspring://team/forms) are documented in Resources → - including formspring://docs/framework-integrations, a JSON pointer to the catalog tool.
Prompts (packaged workflows like /triage-spam) are in Prompts →.
Security in three lines
- Bearer-token auth - every request carries
Authorization: Bearer …. - Per-token abilities - tools refuse if the token lacks the required ability.
- Team-scoped - tokens see only their own team. Revocation is instant.
Details in Authentication →.
Get started
- Mint a token at API tokens with the abilities you want the agent to have.
- Pick your client and follow its install page:
- Restart the client (or reload MCP). Ask it: "List my forms."
Or skip manual config:
- Device authorization - browser sign-in for plugins (
formspring login); no copying tokens by hand. - Formspring agent plugin (
https://github.com/formspring-io/formspring-ai.git) for Cursor and Claude Code (MCP + skills + commands). - In-app setup wizard picks abilities and generates a paste-ready snippet (Cursor gets a one-click deep link).
Endpoint
https://formspring.io/mcp-server
The server speaks the MCP "Streamable HTTP" transport. Bearer-token gated. GET and DELETE return 405 by design - the spec only uses POST for client→server messages.
Native HTTP MCP clients (Claude Code, Cursor, Windsurf, Zed, VS Code, OpenClaw, Hermes Agent) connect to this URL directly. Claude Desktop's Custom Connector UI only handles OAuth, so its install guide uses the mcp-remote bridge to feed the HTTP server into stdio.
What's next
- Tools → - every tool, every parameter
- Prompt examples → - paste-ready prompts
- Troubleshooting → - 401/403 and friends