MCP server · OAuth 2.1 · Works with Claude

The form platform your AI agent can operate.

Formius ships a Model Context Protocol server with 13 scoped tools. Your agent creates forms and lessons, publishes them, reads verified responses, and exports data after you approve access.

Connect your agent Read the agent docs

13 scoped MCP tools OAuth 2.1 and scoped tokens 7-day free trial

What your agent can do

Every tool is scope-gated and announces read or write intent, so MCP clients know what to auto-approve and what to confirm.

formius_create_form

write

Generate a complete form from a natural-language prompt. Persists it as a draft by default and returns the form id, title, status, and URLs.

forms:write

formius_quote_lesson_generation

read

Preview the exact credit cost of an AI lesson for a prompt, language set, and zero to three illustrations without starting generation.

billing:read

formius_create_lesson

write

Create an illustrated AI lesson from an accepted quote, with optional password access, fixed or AI-reviewed tasks, and idempotent credit accounting.

forms:write

formius_get_lesson_generation_status

read

Read lesson generation progress, per-image state, and the exact reserved, charged, and refunded credit amounts for a quote.

billing:read

formius_get_form

read

Read a form: metadata, edit state (response count and lock), URLs, and optionally the full field structure.

forms:read

formius_update_form

write

Update a form with an AI edit prompt, a structure replacement, a status change (publish, pause, archive), or an access password. Breaking edits are blocked once responses exist.

forms:write

formius_list_forms

read

List forms the token owner can access, owned and shared, with optional title query, status filter, and limit.

forms:read

formius_find_form_by_name

read

Fuzzy-find accessible forms by title. Returns the top 5 matches with a match score from 0 to 1.

forms:read

formius_clone_form

write

Clone an accessible form into a new draft owned by the caller, with an optional new title.

forms:write

formius_share_form

write

Share a form with another Formius admin by email with view, edit, or admin permission.

shares:write

formius_get_responses

read

Read form responses with status and date filters. Respondent email is included only when the token holds the responses:read:pii scope.

responses:read

formius_export_responses

read

Export responses as CSV, CSV with file links, or ZIP to private storage and receive a 10 minute signed download URL. Up to 5000 rows per export.

responses:export

formius_get_subscription_status

read

Check subscription access mode and the AI generation quota: used, limit, remaining, and reset time.

billing:read

Connect in two minutes

Paste the endpoint into Claude and sign in with OAuth, or use a scoped access token in clients that send a Bearer header.

Claude.ai and Claude Desktop custom connector

https://www.formius.ai/api/mcp

Claude Code

claude mcp add --transport http --scope user formius https://www.formius.ai/api/mcp
claude mcp login formius

Cursor with a personal access token

{
  "mcpServers": {
    "formius": {
      "url": "https://www.formius.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FORMIUS_PAT"
      }
    }
  }
}

Any MCP client with a personal access token

curl -X POST https://www.formius.ai/api/mcp \
  -H "Authorization: Bearer YOUR_FORMIUS_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Or create a personal access token

Tokens are scoped, support optional expiry, and can be revoked at any time.

Log in to Formius and open Settings, then Integrations.
Create a new access token and select only the scopes your agent needs.
Pick an expiry in days, or no expiry, and create the token.
Copy the token right away. Formius shows it only once; store it in your secret manager.

forms:readList, search, and read forms
forms:writeCreate, update, and clone forms
shares:writeShare forms with other admins
responses:readRead responses without respondent email
responses:read:piiInclude respondent email in responses and exports
responses:exportExport responses to downloadable files
billing:readRead subscription status and generation quota

Rate limit: 120 requests per minute per token. AI generation tools also draw from your plan generation quota.

Full MCP and API reference

Agent questions, answered

What is the Formius MCP server?

A Model Context Protocol endpoint at /api/mcp that exposes 13 tools for creating forms and lessons, managing their lifecycle, reading verified responses, and exporting data. It speaks streamable HTTP and supports OAuth 2.1 or personal access tokens.

Which AI clients can connect?

Claude, Claude Code, and Claude Desktop connect with OAuth. Cursor and other streamable HTTP clients can connect with a scoped personal access token.

Can I connect from claude.ai in the browser?

Yes. Add https://formius.ai/api/mcp as a custom connector, sign in to Formius, and approve access.

Is it safe to let an agent manage my forms?

You decide what a token can do: seven scopes cover reading, writing, sharing, exports, and billing status. Every tool announces read or write intent, breaking edits are blocked once a form has responses, and you can revoke a token at any time.

What does agent access cost?

Nothing extra. MCP access is part of every Formius subscription, and the 7-day free trial includes it.