Install for Claude Code

Recommended: Formspring plugin

Install the official Formspring agent plugin:

text

/plugin marketplace add https://github.com/formspring-io/formspring-ai
/plugin install formspring@formspring

The plugin registers the MCP server, skills, agents, and namespaced commands such as /formspring:create-form and /formspring:triage-spam.

Sign in (device authorization):

Run /formspring:login after install, or
./scripts/device-auth.sh claude-code from the plugin repo

That opens your browser to approve the connection - no copying tokens from the API page.

Alternatively: setup wizard → Connect via browser, or the manual token steps below.

Run /mcp to confirm formspring is listed.
Run /formspring:verify-setup (or paste a setup prompt from the wizard) to confirm tools and see a sample inbox.
For local development: claude --plugin-dir /path/to/formspring-ai then /reload-plugins.

Manual claude mcp add steps below are the fallback without the plugin.

1. Mint a token

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

A safe starter set of abilities:

forms:read, submissions:read, submissions:write, webhooks:read, insights:read.

Add forms:write or webhooks:write only if the agent should mutate things.

2. Add the server

bash

claude mcp add --transport http formspring https://formspring.io/mcp-server \
  --header "Authorization: Bearer your-api-token"

Flags must come before the server name - this is a hard rule in the CLI. The URL is positional, right after the name. Defaults to local scope (writes to ~/.claude.json under the current project).

Other scopes:

--scope project - writes to .mcp.json in the repo root, safe to commit so teammates inherit the same server.
--scope user - available across every project on your machine.

Prefer JSON? Drop this into .mcp.json (project) or ~/.claude.json (local/user):

json

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

"type": "streamable-http" is accepted as an alias, since the MCP spec calls this transport "Streamable HTTP".

3. Verify

text

/mcp

You should see formspring listed with its tools loaded. If it shows failed, jump to Troubleshooting →.

Try a prompt

Paste any of these into a Claude Code session:

"List my forms."

"Triage the last 50 spam submissions on my contact form. Group them by reason and propose two new blocked-emails entries."

"Audit every webhook on every form. Tell me which are unhealthy and why."

Slash-command shortcuts

Save reusable workflows to .claude/commands/triage-spam.md:

markdown

Triage today's spam folder for the contact form.

1. Call list_submissions with folder: "spam", limit: 50
2. Decide keep / mark not-spam / delete for each
3. Apply via bulk_submissions
4. Summarize what you did

Run with /triage-spam.

What's next

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