feat: publish Coder MCP server to official MCP Registry - #21673
Merged
Conversation
This adds the necessary configuration to publish Coder's remote MCP server to the official MCP Registry at registry.modelcontextprotocol.io. Changes: - Add server.json with MCP server metadata for registry discovery - Add GitHub Actions workflow to automatically publish on release The MCP server is accessible at /api/experimental/mcp/http and provides workspace and template management tools for AI agents. Closes #21275
matifali
force-pushed
the
mux/publish-mcp-registry
branch
from
January 25, 2026 07:07
a5a0340 to
877efd8
Compare
Contributor
Documentation CheckUpdates Needed
This addition bridges the gap between the existing "Remote MCP server" section and how users will discover Coder through the registry. Consider adding this as a new section after "Remote MCP server" explaining registry-based discovery as an alternative to manual configuration. No Changes Needed for:
Automated review via Coder Tasks |
matifali
marked this pull request as draft
January 25, 2026 07:09
The version is dynamically set from the git tag during the publish workflow. Using "0.0.0-dev" makes it clear this value is not manually maintained.
The version is dynamically set from the git tag during the GitHub Actions publish workflow. Using 0.0.0-dev makes it clear this value is replaced at publish time.
matifali
marked this pull request as ready for review
January 25, 2026 07:31
Addresses documentation feedback from PR review.
matifali
marked this pull request as draft
January 25, 2026 08:03
The specific server URL will 404 until first publish after merge. Link to the registry root instead. --- _Generated with `mux` • Model: `claude-sonnet-4-20250514` • Thinking: `none`_
- Remove broken registry link (registry has no browsable UI) - Update VS Code instructions to clarify registry discovery - Add comprehensive list of all 30+ available MCP tools - Fix Claude Desktop config to use OAuth2 instead of headers
Maintains the distinction between: - Local MCP server (CLI, stdio transport) - Remote MCP server (HTTP transport, MCP Registry) The MCP Registry publishing only applies to the remote server.
matifali
marked this pull request as ready for review
January 25, 2026 08:42
Keep the document title as "MCP Server" per maintainer preference.
Contributor
Documentation CheckPrevious Feedback✅ Fully Addressed - The documentation has been completely rewritten and now comprehensively covers MCP Registry integration. Updated Documentation IncludesThe PR updates with:
The documentation now provides a complete guide from discovery through configuration, addressing all points from the previous review. No Further Changes NeededThe documentation is comprehensive and ready for users to discover and use Coder through the MCP Registry. Automated review via Coder Tasks |
matifali
marked this pull request as draft
January 26, 2026 02:50
Docs preview📖 View docs preview for |
Add workflow_dispatch with a manual semver version input and an opt-in publish flag. Manual runs default to validate-only (mcp-publisher validate) and never authenticate or publish unless explicitly requested. Version is derived from the tag on release events or the input on manual runs, and rejected unless it is valid semver so branch refs can never be published as a version. Generated with Coder Agents.
Contributor
Documentation CheckUpdates Needed
Automated review via Coder Agents |
Move workflow_dispatch inputs into step env vars so they are not expanded inside run blocks (zizmor template-injection), and set persist-credentials: false on checkout (artipacked). Also run the markdown table formatter on docs/ai-coder/mcp-server.md to satisfy fmt and lint-docs. Generated with Coder Agents.
Point server.json documentation at the real page (/docs/ai-coder/mcp-server). List both the oauth2 and mcp-server-http experiments in Prerequisites, matching the remote MCP HTTP endpoint gate in coderd.go. Add the missing coder_get_template tool and link the tool tables to the authoritative toolsdk package to reduce drift. Generated with Coder Agents.
The per-category tool tables drift from the code over time. Replace them with a short overview of tool areas and a link to the authoritative toolsdk package, matching the previous version of this page. Generated with Coder Agents.
bpmct
approved these changes
Jun 26, 2026
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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
This adds the necessary configuration to publish Coder's remote MCP server to the official MCP Registry at registry.modelcontextprotocol.io.
Changes
server.json: MCP server metadata for registry discovery.github/workflows/publish-mcp-registry.yaml: GitHub Actions workflow to automatically publish on releaseHow it works
MCP Registry Entry
The server will be listed as
io.github.coder/coderwith:streamable-http{coder_url}/api/experimental/mcp/http/.well-known/oauth-authorization-server)Testing
After merge and next release, verify at:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?q=io.github.coder"Closes #21275
Generated with
mux• Model:anthropic:claude-opus-4-5• Thinking:medium