MCP server · Personal access tokens · 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, while you keep control with per-scope access tokens.

Connect your agent Read the agent docs

13 scoped MCP tools Per-scope access 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

Create a token, paste one snippet, done. Works with Claude Code, Claude Desktop, Cursor, and any MCP client that speaks streamable HTTP with a Bearer header.

Claude Code

claude mcp add --transport http formius https://dev.formius.ai/api/mcp --header "Authorization: Bearer YOUR_FORMIUS_PAT"

Claude Desktop

{
  "mcpServers": {
    "formius": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dev.formius.ai/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_FORMIUS_PAT"
      ]
    }
  }
}

Cursor

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

Any MCP client (HTTP)

curl -X POST https://dev.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"}'

Create your 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 authenticates with a personal access token.

Which AI clients can connect?

Claude Code, Claude Desktop through mcp-remote, Cursor, and any MCP client that can send an Authorization Bearer header over streamable HTTP.

Can I connect from claude.ai in the browser?

Not yet. Web connectors on claude.ai require OAuth, and Formius authenticates with personal access tokens today. Use Claude Code, Claude Desktop, or Cursor instead.

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.