Skip to content

feat(mcp): document http auth for MCP Registry publishing in the generated README - #199

Open
AshGodfrey wants to merge 1 commit into
mainfrom
ash/mcp-registry-http-auth-readme
Open

AshGodfrey wants to merge 1 commit into
mainfrom
ash/mcp-registry-http-auth-readme

Conversation

@AshGodfrey

@AshGodfrey AshGodfrey commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Why

The generated MCP server README lists the mcpRegistry.auth methods a workflow can use to publish to the MCP Registry. http is now a supported method (sdk-gen-config v1.61.0 accepts it and sdk-generation-action v15.60.12 logs in with it), but the README only lists github-oidc, github and dns.

What changed

  • templates/templates/mcp-typescript/readme.stmpl: add an http bullet next to dns. http verifies a custom domain namespace through a /.well-known/mcp-registry-auth file instead of a DNS TXT record and uses the same Ed25519 private key. The bullet notes that the file must be served without redirects, because the registry does not follow them.
  • zSDKs/mcp-typescript/README.md: regenerated review output, one added line.
  • Changeset for mcpServer / mcp-typescript.

Testing

  • TARGET=review make build-mcp-typescript: generation and integrity validation pass; the only output change is the added README line.
  • make lint passes.
  • No runtime tests added: the change is static README text.

Public-safety check

  • This change contains no credentials, customer documents, private repository URLs, private filesystem paths, or unredacted private logs.
  • Title, body, comments, and commit messages name no customers or customer-derived identifiers, private paths or trackers, or workflow provenance, and are understandable without private context (.claude/skills/public-repo-communication/SKILL.md).
  • Generated fixtures and review SDK changes are public-safe.
  • I reviewed git diff --check.

Summary by cubic

Documents http as a supported mcpRegistry.auth method in the generated MCP server README. The README previously listed only github-oidc, github, and dns, even though http is now accepted by the generation and publishing tooling.

  • Adds an http bullet to the README template and the regenerated SDK README: it uses the same Ed25519 private key as dns, but verifies a custom domain namespace via a /.well-known/mcp-registry-auth file instead of a DNS TXT record, and that file must be served without redirects.
  • Adds a changeset for mcpServer / mcp-typescript at patch level.

No runtime behavior changes; this is documentation only.

Written for commit dfcfa59. Summary will update on new commits.

View guided diff Turn on auto-fix

@AshGodfrey
AshGodfrey requested a review from a team as a code owner November 6, 2026 12:13
@github-actions github-actions Bot added the mcp-typescript Trigger (16) snapshot tests for mcp-typescript label Nov 6, 2026

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 3 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Shadow auto-approve: would auto-approve. Documentation-only change adding the http MCP Registry auth method to the generated MCP typescript README, with matching regenerated README output and a changeset. The diff is confined to static text and is clearly beneficial.

View guided diff | Turn on auto-fix | Re-trigger cubic

…rated README

The generated MCP server README lists the `mcpRegistry.auth` methods a workflow can use. Add `http`, which verifies a custom domain namespace through a `/.well-known/mcp-registry-auth` file instead of a DNS TXT record and takes the same Ed25519 private key as `dns`.
@AshGodfrey
AshGodfrey force-pushed the ash/mcp-registry-http-auth-readme branch from b809881 to dfcfa59 Compare November 16, 2026 11:10
@speakeasy-generator-bot

speakeasy-generator-bot Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Generator Snapshot Testing

Selector(s) Result Summary
snapshot-mcp-typescript ✅ Snapshot run completed

Snapshot results: https://github.com/speakeasy-api/openapi-generation-snapshots/issues/169#issuecomment-6914909431

Snapshot results are summarized above. Additional run context is linked for maintainers with access.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

mcp-typescript Trigger (16) snapshot tests for mcp-typescript

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants