MCP Integration

​

What is MCP?

The Model Context Protocol (MCP) lets you build Tally forms using natural language through AI assistants like Claude. Instead of clicking through form builders, you can simply tell Claude what you want and it will create your forms for you.

​

Server URL

The Tally MCP server is available at:

https://api.tally.so/mcp

​

Authentication

Access to the MCP server requires an API key in the Authorization header:

Authorization: Bearer tly-xxxx

Learn more about how to get your API key.

​

Configuration Examples

​

HTTP MCP Clients

For AI assistants that support HTTP MCP servers directly, add the following configuration:

{
  "mcpServers": {
    "tally": {
      "type": "http",
      "url": "https://api.tally.so/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

​

Claude Desktop

Some clients might not support HTTP MCP servers directly, but you can use the mcp-remote package to connect to the Tally MCP server.

{
  "mcpServers": {
    "tally": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.tally.so/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY_HERE"
      ]
    }
  }
}

​

Example Usage

Once configured, you can ask your AI assistant to create forms using natural language. Here are some examples:

​

Creating a Simple Contact Form

Create a simple contact form

The AI assistant will automatically create a contact form with commonly expected fields based on its understanding of what a typical contact form should include.

​

Updating the Contact Form

If the generated form isn’t exactly what you wanted, you can easily modify it by following up:

We don't need the Company field, remove the consent checkbox and maybe add a captcha

The AI assisant should correctly modify the form and save it.

​

Creating a form with specific fields

Alternatively, you can be explicit about exactly what fields you want:

Create a contact form with these specific fields:
- Name (required)
- Email (required)
- Phone (optional)
- Message (required)
- Captcha (required)

The AI assistant should create a form with the specified fields and save it.

​

Updating an existing form

Update this form https://tally.so/r/a1B2c3
- Remove the phone number field
- Also add a captcha
- Make company field optional

The AI assistant will use the MCP tools to load your form, make the requested changes, and save the updated version.

​

Example usage with Claude