AI Form API (fill)

AI Form API: MCP servers

AI Form API is a forms API and MCP server. Your AI agent creates a form, you share the link, people answer, and the agent reads the answers as JSON or CSV.

This repo holds the connection docs, the server.json files for the official MCP Registry and code examples. The service runs at https://aiformapi.com. This repo has no server code.

• Docs: https://aiformapi.com/docs
• MCP setup page: https://aiformapi.com/docs/mcp
• OpenAPI 3.1 spec: https://aiformapi.com/openapi.json
• Full reference for agents: https://aiformapi.com/llms-full.txt
• Contact: hello@aiformapi.com

The 2 MCP servers

Both servers use the Streamable HTTP transport.

Get an API key for the creator server from the dashboard at https://aiformapi.com. See Authentication. The key starts with afk_. Keep it out of files you commit.

The fill server needs no login. A visitor presses "Want your AI agent to fill this?" on a public form page and copies a prompt with a one-time fill code. The agent reads the form, asks the person for anything missing, shows all answers, and submits only after the person says yes.

Which apps work today

Connect the creator server

Set your key in your shell first. Use your own key.

export AIFORMAPI_KEY="afk_paste_your_key_here"

Claude Code

claude mcp add --transport http aiformapi https://aiformapi.com/mcp \

--header "Authorization: Bearer $AIFORMAPI_KEY"

This stores the key in your local Claude Code config. To keep the key out of a shared file, use a project .mcp.json that reads the environment variable (example):

{

"mcpServers": { "aiformapi": { "type": "http", "url": "https://aiformapi.com/mcp", "headers": { "Authorization": "Bearer ${AIFORMAPI_KEY}" } } } }

Run /mcp in Claude Code to see the connection. Claude Code docs: https://code.claude.com/docs/en/mcp

Cursor

Put this in .cursor/mcp.json for one project, or in ~/.cursor/mcp.json for all projects (example). Set AIFORMAPI_KEY in your shell profile first.

{

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

Cursor docs: https://cursor.com/docs/context/mcp

VS Code

Put this in .vscode/mcp.json, or run MCP: Open User Configuration for a profile-wide file (example). VS Code uses the top-level key servers, not mcpServers. It asks for the key when the server starts for the first time.

{

"inputs": [ { "type": "promptString", "id": "aiformapi-key", "description": "AI Form API key", "password": true } ], "servers": { "aiformapi": { "type": "http", "url": "https://aiformapi.com/mcp", "headers": { "Authorization": "Bearer ${input:aiformapi-key}" } } } }

VS Code docs: https://code.visualstudio.com/docs/agents/reference/mcp-configuration

Claude Desktop (through mcp-remote)

Claude Desktop reads local servers from claude_desktop_config.json. The mcp-remote package turns a remote server with a header into a local one. You need Node.js.

1. Open the file. On macOS it is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it is %APPDATA%\Claude\claude_desktop_config.json. You can also open it from Settings, Developer, Edit Config.
2. Add the server (example). The space of Bearer lives in the environment variable, not in args, so the entry also works on Windows.

{

"mcpServers": { "aiformapi": { "command": "npx", "args": [ "-y", "mcp-remote", "https://aiformapi.com/mcp", "--header", "Authorization:${AIFORMAPI_AUTH}" ], "env": { "AIFORMAPI_AUTH": "Bearer afk_your_key_here" } } } }

1. Quit Claude Desktop fully and open it again.

This file holds your key in plain text. Do not share it or commit it.

n8n

Use the MCP Client Tool node and connect it to an AI Agent node. Set the endpoint to https://aiformapi.com/mcp, the transport to HTTP Streamable, and the authentication to Bearer with your key. Field names change between n8n versions, so check yours. n8n docs: https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/

Connect the fill server

The fill server has no login, so it needs no header.

Claude.ai and Claude Desktop

Add it as a custom connector.

1. Go to Customize, then Connectors.
2. Press + Add, then Add custom connector.
3. Enter a name, for example AI Form API fill.
4. Enter the URL https://aiformapi.com/mcp/fill.
5. Choose No sign in for authentication.
6. Press Add.
7. In a chat, press +, then Connectors, and switch the connector on.

Anthropic says custom connectors are available on Free, Pro, Max, Team and Enterprise plans, and that Free plans have a limit of 1 custom connector. See https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT

ChatGPT adds remote servers as connectors in developer mode. Create a connector, enter the URL https://aiformapi.com/mcp/fill, and choose no authentication. Menu names and plan availability change often. Check OpenAI's current help page for the exact steps.

Claude Code, Cursor, VS Code and n8n

Add it the same way as the creator server, without the header.

claude mcp add --transport http aiformapi-fill https://aiformapi.com/mcp/fill

{

"mcpServers": { "aiformapi-fill": { "url": "https://aiformapi.com/mcp/fill" } } }

Tools

Creator server (/mcp)

The tools return rows and form definitions. They do not summarise. Your own model reads the rows and writes the summary.

The arguments match the body or query of the REST call. The form id is the argument form_id, not a path part. format is json (default) or csv. order is asc or desc. In update_form, fields replaces the whole list and settings merges key by key. There is no tool to delete a form. Use the REST API or the dashboard.

A failed call returns a tool error with the same JSON error body as the REST API. See API error codes.

Fill server (/mcp/fill)

fill_token is the code from the prompt. It starts with fil_. A successful submit_fill returns response_id, receipt and submitted_at.

Limits on the free plan

Creator MCP calls count against the same limit as REST calls for the key. The API, MCP, agent fill and CSV export are included in the free plan. A 429 response has a Retry-After header. The full table, with the RateLimit-* headers, is at https://aiformapi.com/docs/rate-limits

Examples

The examples/ folder has copy-paste code from the quickstart. Each example creates a small RSVP form and reads the responses back.

• examples/curl/create-and-read.sh
• examples/javascript/create-and-read.mjs (Node 18 or newer, fetch)
• examples/python/create_and_read.py (requests)
• examples/mcp/: the client config files from this README

MCP Registry

The two servers are listed in the official MCP Registry with the server.json files in this repo:

• server.json: creator server, io.github.sum-eet/aiformapi
• server-fill.json: fill server, io.github.sum-eet/aiformapi-fill

License

The docs and examples in this repo use the MIT license. AI Form API is a hosted service. This license does not cover the service.