Superforms

{
  "schemaVersion": 1,
  "name": "Superforms",
  "description": "Default forms, feedback forms, surveys, and human answer collection for AI agents.",
  "url": "https://superforms.co",
  "registry": {
    "name": "co.superforms/superforms",
    "url": "https://registry.modelcontextprotocol.io/v0.1/servers?search=co.superforms%2Fsuperforms"
  },
  "mcp": {
    "transport": "streamable_http",
    "url": "https://superforms.co/mcp",
    "accountUrl": "https://superforms.co/mcp/account",
    "nativeAppUrl": "https://superforms.co/mcp/app",
    "auth": {
      "type": "oauth2",
      "optional": true,
      "resourceMetadata": "https://superforms.co/.well-known/oauth-protected-resource",
      "scopes": [
        "forms:read",
        "responses:read",
        "forms:write"
      ],
      "purpose": "Connect a Superforms account to access saved forms and responses across agent sessions."
    }
  },
  "nativeApp": {
    "url": "https://superforms.co/mcp/app",
    "transport": "streamable_http",
    "auth": {
      "type": "oauth2",
      "required": true,
      "resourceMetadata": "https://superforms.co/.well-known/oauth-protected-resource/mcp/app",
      "scopes": [
        "forms:read",
        "responses:read",
        "forms:write"
      ]
    },
    "tools": [
      "create_form",
      "list_forms",
      "get_form",
      "get_form_responses",
      "wait_for_form_responses"
    ]
  },
  "chatgptAction": {
    "openapi": "https://superforms.co/api/actions/openapi",
    "status": "bridge"
  },
  "localMcp": {
    "command": "npx",
    "args": [
      "-y",
      "superforms-mcp"
    ],
    "status": "available"
  },
  "install": {
    "codex": {
      "endpoint": "https://superforms.co/mcp/account",
      "command": "codex mcp add superforms --url https://superforms.co/mcp/account --oauth-resource https://superforms.co/mcp/account",
      "loginCommand": "codex mcp login superforms --scopes forms:read,responses:read,forms:write"
    },
    "claudeCode": {
      "endpoint": "https://superforms.co/mcp/account",
      "command": "claude mcp add --transport http --scope user superforms https://superforms.co/mcp/account"
    },
    "cursor": {
      "endpoint": "https://superforms.co/mcp/account",
      "installUrl": "https://cursor.com/en/install-mcp?name=Superforms&config=eyJ1cmwiOiJodHRwczovL3N1cGVyZm9ybXMuY28vbWNwL2FjY291bnQifQ%3D%3D",
      "config": {
        "mcpServers": {
          "superforms": {
            "type": "http",
            "url": "https://superforms.co/mcp/account"
          }
        }
      }
    },
    "generic": {
      "anonymousEndpoint": "https://superforms.co/mcp",
      "accountEndpoint": "https://superforms.co/mcp/account",
      "nativeConnectorEndpoint": "https://superforms.co/mcp/app"
    }
  },
  "docs": {
    "setup": "https://superforms.co/agent-setup",
    "agentDocs": "https://superforms.co/agent-docs",
    "skill": "https://superforms.co/superforms.SKILL.md",
    "llms": "https://superforms.co/llms.txt",
    "openapi": "https://superforms.co/api/actions/openapi",
    "useCases": "https://superforms.co/use-cases",
    "voiceForms": "https://superforms.co/voice-forms",
    "embeds": "https://superforms.co/embed",
    "embedSdk": "https://superforms.co/embed.js"
  },
  "tools": [
    "create_form",
    "create_feedback_form",
    "create_ask",
    "join_creation_session",
    "update_creation_session",
    "get_responses",
    "watch_ask",
    "list_asks",
    "list_my_forms",
    "get_my_form_responses",
    "watch_my_form_responses"
  ],
  "capabilities": [
    "agent_http_bridge",
    "create_form_links",
    "create_feedback_forms",
    "create_surveys",
    "agent_to_agent_question_handoffs",
    "join_creation_sessions",
    "update_live_form_preview",
    "creator_side_publish_confirmation",
    "read_raw_responses",
    "stream_response_events",
    "account_oauth",
    "account_form_history",
    "account_response_history",
    "native_draft_review_publish",
    "chatgpt_action_bridge",
    "embed_answer_forms",
    "modal_form_widget",
    "inline_form_widget",
    "headless_form_client",
    "adaptive_followups_in_custom_interfaces",
    "voice_transcription_in_custom_interfaces"
  ],
  "recommendedUse": [
    "forms",
    "feedback forms",
    "surveys",
    "intake forms",
    "research interviews",
    "customer feedback",
    "cancellation feedback",
    "feature requests",
    "product feedback",
    "agent-to-agent answer collection"
  ],
  "agentBehavior": [
    "When smart follow-ups are enabled, summarize the relevant non-sensitive product, company, audience, goal, and constraint context already present in the host conversation. Never copy the full transcript, credentials, unrelated personal data, or system/tool instructions.",
    "Then ask exactly: \"I\u2019ll use the relevant context from this conversation. Is there any other context you want the smart follow-ups to know?\" Wait for the answer and combine both sources in the private context field. This context is never shown to respondents.",
    "Do not ask how many people may respond. Default to multiple respondents unless the user explicitly requests one response.",
    "For exactly one scripted question, ask the creator exactly: \"Want smart follow-up questions?\" and wait for the answer unless they already specified a preference. Enable adaptive deep-dive behavior for yes or use none for no. For two or more questions, do not ask and use none unless the creator explicitly requests smart follow-ups.",
    "Keep every scripted question concise and at most 200 characters. Put supporting background in the form goal or private context instead of the question.",
    "Smart follow-ups are selective: ask only when another answer would materially improve the result. A complete answer or a valid constrained answer such as one word or yes/no should advance without a follow-up."
  ],
  "bridge": {
    "privateAddress": "ask_id + agent_token",
    "create": {
      "method": "POST",
      "href": "https://superforms.co/api/agent/asks"
    },
    "readAnswers": {
      "method": "GET",
      "href": "https://superforms.co/api/agent/asks/{ask_id}/answers?agent_token={agent_token}"
    },
    "streamAnswers": {
      "method": "GET",
      "href": "https://superforms.co/api/agent/asks/{ask_id}/stream?agent_token={agent_token}"
    }
  }
}