Install for Cursor

Recommended: Formspring plugin + device sign-in

Install the official Formspring agent plugin from the Cursor marketplace, or import the repo as a team marketplace (Dashboard → Settings → Plugins → Import https://github.com/formspring-io/formspring-ai).

The plugin bundles MCP wiring (mcp.json), skills, agents, product-routing rules, and commands for forms, surveys, funnels, and triage workflows.

Sign in (no token copy):

bash

git clone https://github.com/formspring-io/formspring-ai.git
cd formspring-ai
./scripts/device-auth.sh cursor

Add the printed export FORMSPRING_TOKEN=... to your shell profile, reload Cursor (Developer: Reload Window), and confirm Settings → MCP shows formspring enabled.

Then paste the Verify connection prompt from the setup wizard (or ask the agent to run the same steps as the plugin’s prompts/verify.md).

Or use the setup wizard → Connect via browser after picking Cursor.

Optional: enable the formspring-product-routing rule under Settings → Rules.

Local development: symlink the cloned repo to ~/.cursor/plugins/local/formspring and reload.

The sections below are the manual MCP-only path if you skip the plugin.

1. Mint a token

Open API tokens, create a token, copy the value (shown once).

A safe starter set for inbox + triage on any plan:

forms:read, submissions:read, submissions:write, links:read, automations:read.

Add webhooks:read, surveys:read, funnels:read, or insights:read when your team is on Pro or higher and you need those products. The setup wizard selects the right defaults for your plan.

2. Add the MCP server

Create .cursor/mcp.json at your project root (or ~/.cursor/mcp.json for global):

json

{
  "mcpServers": {
    "formspring": {
      "url": "https://formspring.io/mcp-server",
      "headers": {
        "Authorization": "Bearer ${env:FORMSPRING_TOKEN}"
      }
    }
  }
}

Cursor resolves ${env:VAR} against your shell environment at MCP startup, so you can put the literal token inline for a quick test, but for anything checked into git use the env-var form and export the token from your shell rc file.

The faster path is the in-app setup wizard - pick Cursor and it generates a Cursor deep-link (cursor://anysphere.cursor-deeplink/mcp/install?...) that installs the server in one click.

3. Reload

⌘⇧P → Cursor: Reload Window, or restart Cursor. Then go to Settings → MCP and confirm formspring is toggled on.

Try a prompt

"List my forms."

"What submissions came in this week on the contact form? Group by category."

"Audit my webhooks. Which have failed deliveries in the last 24 hours?"

What's next

Tools → - full catalogue
Prompt examples → - paste-ready workflows
Troubleshooting → - 401/403 fixes