# Superforms

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

- name: co.superforms/superforms
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 86/100
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/co.superforms%2Fsuperforms
- tools: https://api.protogrid.dev/v1/servers/co.superforms%2Fsuperforms/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "superforms": {
      "type": "http",
      "url": "https://superforms.co/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 75
- drivers: +repository +dns-namespace +reachable +uptime-100% ~updated-138d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- warn `tools.annotations`: only 6 of 11 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 6 of 11 tools declare all four hints; missing: create_form (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_feedback_form (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_ask (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,666 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 1 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 11, about 2,666 tokens to load them all
- tool set hash: 22c21aeb0445da2c6dd545e420f42ae9
- tools last changed: 2026-10-14T21:27:36.938Z
- badge: [![protogrid quality](https://protogrid.dev/badge/co.superforms/superforms.svg)](https://protogrid.dev/servers/co.superforms/superforms)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-14 `watch_ask` changed (description)
  - before: Return as soon as an individual answer is saved, including answers received while an agent was reconnecting and while the form remains in progress. Use since for durable per-answer catch-up; the HTTP bridge also exposes an SSE stream endpoint.
  - after: Wait up to two minutes and return as soon as an individual answer is saved, including answers received while an agent was reconnecting and while the form remains in progress. The wait ends when this call returns; nothing keeps watching afterward. Pass the returned nextSince as since to continue without repeating answers; the HTTP bridge also exposes an SSE stream endpoint.

Full history: https://api.protogrid.dev/v1/servers/co.superforms%2Fsuperforms/changes

## Remotes

- https://superforms.co/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (11)

- `create_ask`: Create a voice-first Superforms answer link for human input. Backward-compatible alias for create_form.
- `create_feedback_form`: Publish a voice-first feedback, cancellation, feature request, survey, or research form immediately after creator confirmation, with optional smart follow-ups.
- `create_form`: Publish a voice-first form link immediately after creator confirmation, collect human answers, and pipe responses back to the agent.
- `get_my_form_responses`: Read persisted raw responses for a form owned by the connected Superforms account. No per-form agent token is required.
- `get_responses`: Fetch persisted raw responses for a Superforms ask. This is the MCP equivalent of the HTTP bridge answers endpoint.
- `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.
- `list_asks`: List recent asks for a provided private agent token.
- `list_my_forms`: List forms owned by the connected Superforms account, including response counts and latest response timestamps.
- `update_creation_session`: Update a homepage creation handoff draft with the current form title, questions, and settings before the user clicks Set live.
- `watch_ask`: Wait up to two minutes and return as soon as an individual answer is saved, including answers received while an agent was reconnecting and while the form remains in progress. The wait ends when this call returns; nothing keeps watching afterward. Pass the returned nextSince as since to continue without repeating answers; the HTTP bridge also exposes an SSE stream endpoint.
- `watch_my_form_responses`: Return any existing individual answers immediately, or wait briefly until the respondent saves their next answer, even while the form remains in progress.