All docs
7 min read Last updated:

Tools

Every tool checks the token's abilities before running; missing the ability returns a refusal. The tables below cover the complete workspace surface area registered on the server (74 tools).

Plan visibility

tools/list, resources/list, and prompts/list are filtered by the authenticated team's plan. On Free, survey, funnel, webhook, and AI tools (and their matching resources/prompts) are omitted entirely - clients that only read the list will not see them. On Pro and above, the full catalogue is returned.

You can still mint token abilities for paid products on any plan; without the plan feature, those tools either never appear in the list or refuse at call time with a plan error.

Plan MCP products available
Free Forms, submissions, links, automations, billing (read-only), tokens, framework catalog
Pro and above Everything in Free + webhooks, surveys, funnels, AI insights

Product routing

  • Forms - single-screen contact-style forms. Use create_form, not create_survey.
  • Surveys - multi-screen questionnaires, quizzes, NPS. Use create_survey, not create_form.
  • Funnels - multi-step lead-gen with screens, blocks, scoring, pixels, CAPI. Use create_funnel.
  • Links - branded short links and QR codes on every plan.

Call list_templates with product (form, survey, or funnel) before create_* when the user wants a starter. Pass the returned key as template on create_form, create_survey, or create_funnel.

Templates

Tool Ability Description
list_templates forms:read (form), surveys:read (survey), funnels:read (funnel) List starter templates; optional category and search filters. Survey and funnel products require a paid plan.

Forms

Tool Ability Description
list_forms forms:read List active forms in the team
get_form forms:read Fetch one form by public_id
create_form forms:write Create a new form (optional template key from list_templates)
update_form forms:write Patch fields, theme, settings, custom rules
publish_form forms:write Set published_at = now()
unpublish_form forms:write Clear published_at
archive_form forms:write Soft-delete
restore_form forms:write Reverse archive
send_test_autoresponder forms:test-email Send preview autoresponder to your account email
send_test_notification forms:test-email Send preview owner-notification

Submissions

Tool Ability Description
list_submissions submissions:read Paginate, filter by folder
get_submission submissions:read Fetch one with files
update_submission submissions:write Patch payload or status
delete_submission submissions:write Permanent delete + file cleanup
bulk_submissions submissions:write Up to 500 ids: delete, mark_spam, mark_not_spam
export_submissions submissions:export Inline JSON, up to 500 rows
get_submission_file submissions:read Short-TTL signed URL
mark_as_spam submissions:write Quick mark with reason manual:mcp
get_form_stats submissions:read 30-day totals, spam ratio, AI score average

Webhooks

Tool Ability Description
list_webhooks webhooks:read Webhooks for a form, with delivery counts
get_webhook webhooks:read Single webhook (no secret)
create_webhook webhooks:write Returns plaintext signing secret ONCE
update_webhook webhooks:write URL, label, active flag
delete_webhook webhooks:write Remove
list_webhook_deliveries webhooks:read Last 50 (configurable up to 200)
replay_webhook_delivery webhooks:write Re-dispatch a previous delivery

Surveys

Surveys are a separate product from Forms - multi-screen questionnaires, quizzes, and NPS flows with conditional logic. Never call create_form to make a survey, or create_survey to make a contact form. All survey tools require a paid plan.

Tool Ability Description
list_surveys surveys:read List surveys belonging to the current team
get_survey surveys:read Fetch a single survey by public_id
create_survey surveys:write Create a new survey (optionally from a template)
update_survey surveys:write Update name, fields, theme, settings, scoring, notification emails
publish_survey surveys:write Publish - make the survey live and respondable
unpublish_survey surveys:write Return to draft, stop accepting responses
delete_survey surveys:write Soft-delete (recoverable from the dashboard)

Funnels

Funnels are multi-step lead-gen / quiz funnels with screens, blocks, scoring, pixels, A/B tests, and server-side CAPI. All funnel tools require a paid plan. Funnel tools accept either public_id (preferred, mirrors forms/surveys) or the legacy slug to identify a funnel.

Tool Ability Description
list_funnels funnels:read List funnels for the current team
get_funnel funnels:read Get a funnel by public_id (preferred) or slug
create_funnel funnels:write Create a blank funnel or hydrate a gallery template via template
update_funnel funnels:write Update top-level config and replace screens
publish_funnel funnels:publish Publish or unpublish a funnel
delete_funnel funnels:write Soft-delete (recoverable)
get_funnel_analytics funnels:analytics Funnel analytics summary
list_funnel_sessions funnels:analytics Recent sessions for a funnel
add_screen funnels:write Add a screen to a funnel
add_block funnels:write Add a block to a funnel screen
set_logic funnels:write Attach an AND/OR DSL logic rule to a block
set_score funnels:write Attach a per-block score map (bucket → points)
set_pixel funnels:write Set browser-side pixel IDs (GA4 / GTM / Meta / TikTok / LinkedIn / Pinterest / Snap / Bing / Reddit / Twitter)
set_capi_token funnels:write Configure server-side CAPI credentials for a vendor (meta / tiktok / linkedin / pinterest)

Links

Branded short links and QR codes. Available on every plan.

Tool Ability Description
list_links links:read List short links for the current team
get_link links:read Fetch one short link by id or slug
create_link links:write Create a new short link
update_link links:write Update an existing short link
delete_link links:write Soft-delete a short link

Automations

Per-form automation rules with steps that fire on submission events. Available on every plan. Use list_automations with a form's public_id; the team-wide formspring://team/automations resource lists automations across forms, surveys, and funnels.

Tool Ability Description
list_automations automations:read List automations for a form (form_id = form public_id)
get_automation automations:read Get a single automation with its steps
create_automation automations:write Create a new automation
update_automation automations:write Update top-level fields (steps via dedicated tools)
enable_automation automations:write Enable an automation
disable_automation automations:write Disable an automation
delete_automation automations:write Permanent delete (with steps + runs)
run_automation automations:run Manually trigger an automation
list_automation_runs automations:read List recent runs
get_automation_run automations:read Get one run with per-step outputs
replay_automation_run automations:run Replay a previous run

Billing (read-only)

Tool Ability Description
get_team billing:read Current team summary
get_plan billing:read Plan key, features, limits
get_usage billing:read Current period: submissions, storage, deliveries
get_subscription_state billing:read active / on_trial / on_grace_period / past_due / canceled

AI Insights

Tool Ability Description
get_ai_insights insights:read Insights payload (or { locked: true })
regenerate_ai_insights insights:write Trigger regen; locked 5 min between calls

Tokens (self-management)

Tool Ability Description
list_tokens tokens:read Your own tokens
create_token tokens:write Mint a token; abilities ⊆ caller's
revoke_token tokens:write Revoke (refuses on the active token)

Integration reference

Tool Ability Description
get_framework_integration_catalog forms:read Returns a maximum-breadth matrix of stacks (React, Next.js, Laravel, WordPress, mobile, serverless, …): each row includes a short copy-paste snippet (placeholder FORMSPRING_ENDPOINT → your https://…/f/{public_id}), notes (CORS, hosted vs legacy payloads, etc.), docs_url into this site's /docs/…, and optional recipe_slug when a long-form recipe exists. Supports optional category (spa, ssr, static, mobile, backend, cms, edge) and pagination page / per_page (max 100 per page). Deep guides remain on the docs site; MCP returns the compact matrix.

Example call

text
get_framework_integration_catalog {
  "category": "ssr",
  "page": 1,
  "per_page": 25
}

Example call

text
list_submissions {
  form_id: "r2EdO-orF-3S",
  folder: "spam",
  limit: 25
}

returns

json
{
  "submissions": [
    {
      "id": "01HFXX0X9R7KZJVN9VS6TG2C5T",
      "status": "spam",
      "spam_reason": "akismet",
      "ai_moderation_score": 87,
      "payload": { "email": "spam@bad.com", "message": "..." },
      "created_at": "2026-05-07T16:09:10Z"
    }
  ]
}

What's next