MCP server

Questionario MCP

Questionario exposes a paid MCP server so AI agents can create, publish, share, and review hosted forms after user authorization.

MCP endpoint Server card AI agents

Connect

Visible MCP and OAuth discovery links

Agents that rely on body text, visible links, indexed pages, or sitemap entries can find the Questionario MCP integration from this page.

MCP server https://api.usequestionario.com/mcp MCP server card https://usequestionario.com/.well-known/mcp/server-card.json MCP discovery https://usequestionario.com/.well-known/mcp-server API catalog https://usequestionario.com/.well-known/api-catalog.json Auth.md https://usequestionario.com/auth.md llms.txt https://usequestionario.com/llms.txt OAuth protected resource metadata https://api.usequestionario.com/.well-known/oauth-protected-resource/mcp OAuth authorization server metadata https://api.usequestionario.com/.well-known/oauth-authorization-server

Authorization

Required OAuth scopes

forms:read
forms:write
forms:publish
responses:read
billing:read
billing:write
account:read
account:write

Clients

Agent setup examples

Codex

[mcp_servers.questionario]
url = "https://api.usequestionario.com/mcp"

Then run the client login command for the server so OAuth can issue a user-authorized token.

Claude Code

claude mcp add --transport http questionario https://api.usequestionario.com/mcp

Use the client MCP authentication flow when prompted.

ChatGPT

Add Questionario as a custom MCP connector with the server URL above. ChatGPT can use the OAuth metadata to register a client and complete user authorization.

Copilot

Add the Questionario server URL in your Copilot MCP configuration. Use OAuth when the client prompts for authorization.

Generic MCP JSON

{
  "mcpServers": {
    "questionario": {
      "url": "https://api.usequestionario.com/mcp"
    }
  }
}

Clients that support OAuth protected-resource metadata can discover auth endpoints from the server.

Tools

What agents can do

Create forms

Read the field catalog and create hosted form drafts with explicit fields.

Edit and preview

Edit owned forms, preview forms, and inspect account readiness before publication.

Publish hosted links

Publish forms and return public hosted URLs that the user can share.

Archive or delete

Archive published forms or delete forms when the user's entitlement allows it.

Review responses

List responses, read one response, and summarize results for visible responses.

Manage billing

Create Stripe Checkout sessions and open the Stripe customer billing portal.

Payment

How an agent pays for hosted forms

The agent calls get_billing_status to see whether the user can create or publish.
If payment is needed, the agent calls create_checkout_session with product: "single_form", "form_pack", or "pro".
The user opens the Stripe Checkout URL and completes payment. The agent never handles card details.
Questionario receives the Stripe webhook and grants the form credit or Pro entitlement.
The agent retries create_form or publish_form and receives the hosted URL.