Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 20 additions & 9 deletions third_party/typeform/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,30 +29,41 @@ Auth is OAuth. Cursor prompts for Typeform sign-in when the plugin connects. Per

## Before you connect

This plugin points at Typeform's default data center. If your account is hosted in the EU, change the server URL to `https://api.eu.typeform.com/mcp` or `https://api.typeform.eu/mcp` depending on where your account lives.
This plugin points at `https://api.typeform.com/mcp`, which serves Typeform's default data center. EU-hosted accounts use a different URL, and the two EU hosts are **not** interchangeable:

| Account | Server URL | Authorization server |
| --- | --- | --- |
| Default data center | `https://api.typeform.com/mcp` | `https://api.typeform.com` |
| EU data center 1 | `https://api.eu.typeform.com/mcp` | `https://api.typeform.com` |
| EU data center 2 | `https://api.typeform.eu/mcp` | `https://api.typeform.eu` |

`api.typeform.eu` is a separate stack with its own issuer, token endpoint, and JWKS, so tokens are not portable between it and `api.typeform.com`. Picking the wrong host fails during the OAuth exchange rather than at install time.

EU-hosted accounts are only available on Typeform Enterprise plans. If you're not sure which applies, contact your Typeform Success Manager.

## What agents can do

| Category | Capabilities |
| --- | --- |
| Forms | List, read, and create forms, and check form capabilities |
| Forms | List, read, create, edit, and publish forms |
| Themes | List the themes available to the user and apply one to a form |
| Automations | Build and publish automations with email, webhook, delay, and integration steps |
| Insights | Discover and analyze response data |
| Contacts | List contacts and import form responses by mapping |
| Workspaces & accounts | List workspaces and accounts |
| Contacts | Manage contacts and lists, including bulk upsert and form field mapping |
| Workspaces & accounts | List accounts and workspaces |

The hosted runtime is the source of truth for tool names and schemas. Call `accounts-list_accounts` as a read-only smoke test after connecting.

## Notes

- Tool calls run as the Typeform user who authorizes the connection. Scopes requested include `accounts:read`, `forms:read`, `forms:write`, `contacts:read`, `contacts:write`, `insights:read`, and `workspaces:read`.
- Typeform describes this as a generally available beta with limited capabilities, so the tool catalog can change.
- Tool calls run as the Typeform user who authorizes the connection. The server's authorization challenge advertises `accounts:read`, `automations:read`, `automations:write`, `contacts:read`, `contacts:write`, `forms:read`, `forms:write`, `insights:read`, `responses:read`, `responses:write`, `webhooks:read`, `webhooks:write`, `workspaces:read`, and `workspaces:write`.
- Typeform is actively expanding and improving the capabilities in this MCP server.
- Streamable HTTP is the only supported transport — there is no SSE endpoint.
- If the connection shows no tools right after authorizing, refresh the tool list; Typeform documents this as a known issue.

## Docs

- Typeform MCP server: https://developers.typeform.com/developers/get-started/mcp/
- Connect Typeform to your AI: https://help.typeform.com/hc/en-us/articles/50533862636308-Connect-Typeform-to-your-AI-with-the-Typeform-MCP-server
- Typeform MCP server: https://developers.typeform.com/developers/mcp/
- Connect Typeform to your AI: https://help.typeform.com/hc/en-us/articles/50533862636308
- Server URL: https://api.typeform.com/mcp

Logo is Typeform's official mark, from the `Typeform` GitHub organization.
Expand Down