Connect your agent

ffforms runs an MCP server — a standard way for AI agents to use external tools. Connect it once, and your agent can create forms and read submissions on your behalf.

You only need two things:

The MCP endpoint: https://ffforms.com/mcp
Your API key from Get started (looks like fff_live_...)

Pick your tool below.

Claude Code

Add the server from your terminal, passing your key as a header:

claude mcp add --transport http ffforms https://ffforms.com/mcp \
  --header "Authorization: Bearer fff_live_..."

That's it. Start Claude Code and ask it to create a form — it will use the ffforms tools automatically. Run claude mcp list to confirm it's connected.

Cursor

Add ffforms to your MCP config. Use ~/.cursor/mcp.json for all projects, or .cursor/mcp.json inside one project:

{
  "mcpServers": {
    "ffforms": {
      "url": "https://ffforms.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FFFORMS_API_KEY}"
      }
    }
  }
}

Set FFFORMS_API_KEY in your environment so your key isn't sitting in the file. Then enable ffforms under Cursor's MCP settings.

Claude desktop & claude.ai

These clients connect through OAuth instead of a pasted key — you sign in through your browser, no API key to copy.

Open Settings → Connectors → Add custom connector.
Enter the URL: https://ffforms.com/mcp
Follow the sign-in prompt. Your agent is now connected.

Any other MCP client

ffforms works with any MCP client that supports remote (HTTP) servers. Point it at:

https://ffforms.com/mcp

and authenticate one of two ways:

API key — send Authorization: Bearer fff_live_... as a header.
OAuth — if your client supports it, sign in through the standard OAuth flow (no key needed).

Both reach the exact same tools, so use whichever your client makes easier.

Check it worked

Ask your agent something simple:

"List my ffforms forms."

If it comes back with an answer (even an empty list), you're connected.

Troubleshooting

"Unauthorized" or the tools don't appear — your key is missing or wrong. Re-check the Authorization header, or sign in again for OAuth clients.
Client won't accept a header — some desktop apps only support OAuth for custom servers. Use the OAuth flow (Claude desktop above) instead of an API-key header.
Lost your key — you can't recover it, but you can mint a new one. Ask your agent to create a new API key, or use the REST API.

Get started

Building forms