co.superforms/superforms

Official8 tools

Superforms

Human-input bridge for AI agents with voice-first answer links, MCP tools, and HTTP APIs.

Bridge human input to AI agents via voice-first forms, MCP tools, and HTTP APIs.

Captured live from the server via tools/list.

create_form

Create a voice-first form link that collects human answers and pipes responses back to the agent.

Parameters (13)

promptstring
Plain-English ask or request. Use only when explicit questions are not already known.
questionsarray
Explicit questions to ask the respondent. Use this whenever questions already exist; preserve them exactly.
goalstring
contextstring
Hidden context for the form.
questionContextobject
creationSessionUrlstring
titlestring
persistentboolean
followUpModestring
max_followups_per_questionnumber
Maximum AI follow-up questions per specified question. Use 1 for optional specified-question follow-ups.
max_total_questionsnumber
Total question safety cap. Use 20 for open-ended feedback conversations.
responseModestring
responseLimitstring
Use "one" for a form intended for one named person/client. Use "multiple" for forms, surveys, feedback, customers, users, and public/embedded links.

create_feedback_form

Create a voice-first feedback, cancellation, feature request, survey, or research form with optional smart follow-ups.

Parameters (13)

promptstring
Plain-English ask or request. Use only when explicit questions are not already known.
questionsarray
Explicit questions to ask the respondent. Use this whenever questions already exist; preserve them exactly.
goalstring
contextstring
Hidden context for the form.
questionContextobject
creationSessionUrlstring
titlestring
persistentboolean
followUpModestring
max_followups_per_questionnumber
Maximum AI follow-up questions per specified question. Use 1 for optional specified-question follow-ups.
max_total_questionsnumber
Total question safety cap. Use 20 for open-ended feedback conversations.
responseModestring
responseLimitstring
Use "one" for a form intended for one named person/client. Use "multiple" for forms, surveys, feedback, customers, users, and public/embedded links.

create_ask

Create a voice-first Superforms answer link for human input. Backward-compatible alias for create_form.

Parameters (13)

promptstring
Plain-English ask or request. Use only when explicit questions are not already known.
questionsarray
Explicit questions to ask the respondent. Use this whenever questions already exist; preserve them exactly.
goalstring
contextstring
Hidden context for the form.
questionContextobject
creationSessionUrlstring
titlestring
persistentboolean
followUpModestring
max_followups_per_questionnumber
Maximum AI follow-up questions per specified question. Use 1 for optional specified-question follow-ups.
max_total_questionsnumber
Total question safety cap. Use 20 for open-ended feedback conversations.
responseModestring
responseLimitstring
Use "one" for a form intended for one named person/client. Use "multiple" for forms, surveys, feedback, customers, users, and public/embedded links.

join_creation_session

Join a Superforms homepage creation handoff session before creating the real form. Pass agentName with the client name, such as Codex, Claude Code, Claude, ChatGPT, or Cursor.

Parameters (2)

creationSessionUrlstringrequired
agentNamestring

update_creation_session

Update a homepage creation handoff draft with the current form title and questions before the final answer link is created.

Parameters (3)

creationSessionUrlstringrequired
titlestring
questionsarray
Current draft questions to show in the live form preview.

get_responses

Fetch persisted raw responses for a Superforms ask. This is the MCP equivalent of the HTTP bridge answers endpoint.

Parameters (3)

askIdstringrequired
agentTokenstringrequired
sincestring

list_asks

List recent asks for a provided private agent token.

Parameters (1)

agentTokenstringrequired

watch_ask

Check whether a Superforms ask has responses. Use get_responses for repeat polling; the HTTP bridge also exposes an SSE stream endpoint.

Parameters (3)

urlstringrequired
askIdstring
agentTokenstringrequired

Install

claude_desktop_config.json

{
  "mcpServers": {
    "superforms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://superforms.co/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.