AI access & API keys

Connect Claude, ChatGPT, or your own tools to Formtoro with the MCP server and scoped API keys.

Formtoro isn't only driven from the admin. You can connect AI clients (like Claude or ChatGPT) and your own scripts to read your analytics and build forms — through the MCP server and API keys. Manage both in Settings → API and MCP connections.

Connect an AI client (MCP)

Formtoro runs a hosted MCP (Model Context Protocol) server, so MCP-compatible AI clients can work with your shop on your behalf. The client prompts you to sign in to Formtoro and approve the connection — so you stay in control.

The server URL is:

https://mcp.formtoro.com/mcp

You'll find the same URL, with copy buttons, under Settings → API and MCP connections → Connect a new client.

Claude Desktop

Add this entry to your Claude Desktop config file, then restart Claude:

{
  "mcpServers": {
    "formtoro": {
      "url": "https://mcp.formtoro.com/mcp"
    }
  }
}

The config file lives at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI)

Run this in your terminal:

claude mcp add formtoro https://mcp.formtoro.com/mcp

ChatGPT

Open ChatGPT → Settings → Connectors → Add custom MCP server, then paste the server URL.

After connecting

The first time a client connects, it opens a Formtoro sign-in and asks you to approve access. Once approved, the connection appears under Settings → API and MCP connections, showing when it connected and was last used. Connections are per team member — you only see the ones you authorized — and you can Disconnect any of them at any time, which immediately revokes access.

What an AI client can do

Through the MCP server, a connected assistant can, for example:

List and read your forms, and inspect the available building blocks.
Draft a new form or update an existing one (as a draft).
Validate a form's structure before saving.
Read your analytics — funnels, step drop-off, response distributions, attribution, and more — to answer questions about performance.

It's the same intelligence as Luigi in the builder, available from your own AI client.

API keys

For scripts and integrations, mint an API key under Settings → API and MCP connections.

Choose Generate API key.
Give it a name you'll recognize later (e.g. "BI script" or "Zapier").
Select the permissions (scopes) it should have — at least one is required.
Copy the key. This is the only time the key is shown, so store it somewhere safe.

Scopes

Each key is least-privilege — it can only do what you grant:

Scope	Grants
Analytics	Read funnels, drop-off, engagement, devices, trends, attribution, revenue, discount performance, subscriptions, and experiment results.
Discounts	Read your discount definitions (id, name, status, config). Read-only, no customer data.
Branding	Read your themes and confirmed brand (logo, colors, fonts). Read-only, no customer data.
Form editing	Create and edit forms as drafts. Does not publish or change live forms.
Customer lifetime value	Read customer-level lifetime value. Grant only to trusted integrations.

You can only grant scopes your own role already has. Edit permissions on a key takes effect immediately without changing the key itself, and Revoke permanently disables a key right away.

Next steps

Luigi, your AI assistant — the in-app version of the same capabilities.
Settings & team — the rest of your admin settings.

AI access & API keys

On this page