docs(typeform): correct EU hosts, scopes, and the capability table - #373
Open
pol-borrellas wants to merge 5 commits into
Open
pol-borrellas wants to merge 5 commits into
pol-borrellas wants to merge 5 commits into
Conversation
Three factual corrections to the Typeform plugin README, from the Typeform side. Verified against the live MCP server rather than inferred. - The two EU hosts were presented as interchangeable alternatives. They are not: api.eu.typeform.com is an EU resource authorized by api.typeform.com, while api.typeform.eu is a separate stack with its own issuer. Tokens do not move between them, and choosing wrong fails mid-OAuth rather than at install. - The capability table omitted Themes and Automations entirely, and the Forms row didn't mention editing or publishing. - The scope list named 7 scopes; the server's 401 challenge advertises 14. README only, so the plugin manifest and mcp.json are untouched. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Polishing.
pol-borrellas
marked this pull request as ready for review
September 15, 2026 06:39
CalciumG
reviewed
Sep 15, 2026
CalciumG
approved these changes
Sep 15, 2026
Author
|
Hello, @SamSokolin ! I'm Pol, the Lead PM in charge of Typeform's MCP server. Could you merge this PR updating the README file on Typeform's MCP server, please? Thanks! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hi — I work at Typeform. Three factual corrections to our plugin's README, all verified against the live MCP server rather than inferred. README only;
plugin.jsonandmcp.jsonare untouched.1. The two EU hosts aren't interchangeable
The page offered
api.eu.typeform.comorapi.typeform.eu"depending on where your account lives", which reads as two spellings of the same thing. They're different:https://api.typeform.com/mcphttps://api.typeform.comhttps://api.eu.typeform.com/mcphttps://api.typeform.comtypeform.euhttps://api.typeform.eu/mcphttps://api.typeform.euapi.typeform.euhas its own issuer, token endpoint, and JWKS, so tokens don't move between the two. Verified from each host's/.well-known/oauth-protected-resource. This is the one most worth fixing: picking the wrong host fails partway through the OAuth exchange, not at install time, so it presents as a confusing auth bug.2. The capability table was missing two categories
Themes and Automations weren't listed at all, and the Forms row didn't mention editing or publishing. Agents reading this table won't try what they can't see.
3. The scope list named 7 of 14
The server's
401challenge advertisesaccounts: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,workspaces:write.Everything else checked out and I left it alone — the OAuth-only note is right, personal access tokens are rejected, there's no SSE endpoint (
/mcp/sseand/sseboth 404), and the docs link 301s correctly to its canonical target.Happy to adjust tone or trim any of this to match how you'd rather the directory read. If it's useful, we can also review future changes to this plugin before they ship.
🤖 Generated with Claude Code
Note
Low Risk
README-only factual corrections with no runtime, config, or security code changes.
Overview
Documentation-only update to the Typeform plugin README so setup and agent capabilities match the live MCP server.
The Before you connect section now spells out default vs two EU endpoints in a table (MCP URL and authorization server), explains that
api.typeform.euis a separate OAuth stack with non-portable tokens, and notes Enterprise-only EU hosting.The What agents can do table adds Themes and Automations, expands Forms (edit/publish) and Contacts (lists, bulk upsert, mapping), and lightly rewords workspaces/accounts.
Notes and Docs refresh the OAuth scope list to the full set advertised by the server (including automations, responses, webhooks, and workspace write), replace the beta/limited-capabilities wording with active-expansion language, drop the post-auth empty-tools refresh tip, and point to updated developer/help URLs.
Reviewed by Cursor Bugbot for commit 7f48ddb. Bugbot is set up for automated code reviews on this repo. Configure here.