feat: add Seam Docs MCP server install instructions#1106
Merged
Conversation
Adds setup and usage documentation for the public Seam Docs MCP server to the existing API reference Installation page (renders at /latest/api/installation). Required public landing page for the Anthropic MCP marketplace submission. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Updates the Seam Docs MCP server section to reflect that search and fetch tools also cover the 400+ supported device models. Adds device- oriented example prompts, display names for each tool, and a search tip for device queries. Aligns with the marketplace listing copy. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Renames the API reference Installation page to "SDK Installation" and moves the Seam Docs MCP server content to a new "MCP Installation" page at /latest/api/mcp-installation. Adds a success callout near the top of the SDK page encouraging Claude users to install the MCP server first so Claude can guide them through implementation. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds mcp-cover.png to docs/api-reference/.gitbook/assets and references it from the MCP Installation page frontmatter. Updates the codegen delete pattern to preserve the asset folder and the hand-maintained mcp-installation.md across regenerations, and removes the page from the codegen source tree (it no longer flows through metalsmith, so its frontmatter — including cover — is preserved verbatim). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
2 participants
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.
Summary
Adds public setup and usage documentation for the Seam Docs MCP server to the API reference Installation page. This is the landing page we'll cite in our submission to Anthropic's MCP marketplace, per the spec requirement for "public documentation… with clear setup and usage instructions."
docs/api-reference/installation.md(and matching codegen source atcodegen/source/docs/api-reference/installation.md)claude/publish-seam-marketplace-6IDwzThe page covers:
https://mcp.seam.co/mcp), Streamable HTTP transport, no authsearch_docs,get_doc,list_doc_sections)Deviations from spec
/latest/api/installationpage rather than creating a new file. The spec said the URL is fixed and asked me to "figure out the matching file location," but that URL already serves the SDK installation page (docs/api-reference/installation.md). To avoid breaking the existing URL while still meeting the marketplace requirement, I restructured the page into two top-level sections — Seam SDKs (existing content, preserved verbatim) and Seam Docs MCP Server (new). Both audiences are served from one URL. If you'd rather have a dedicated MCP-only page (e.g.,/latest/api/mcp-server), let me know and I'll move it.seamapi/seam-mcp/README.md. The spec asked me to verify the connection JSON against that repo, but it returned 404 (private or different name). I used the standard Claude Code MCP HTTP form (claude mcp add --transport http …plus the equivalent JSONmcpServersblock). Worth a sanity check against the real README before we publish.Test plan
npm run lint— passesnpm run validate-paths— passesnpm run validate-links— passesnpm run validate-orphan-pages— passesseamapi/seam-mcp/README.md🤖 Generated with Claude Code