diff --git a/third_party/typeform/README.md b/third_party/typeform/README.md index 6e3d84b49..61a778ee5 100644 --- a/third_party/typeform/README.md +++ b/third_party/typeform/README.md @@ -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.