Skip to content

Publish MCP Server Card for HTTP discovery (/.well-known/mcp/server-card.json)#37

Draft
baanish wants to merge 1 commit intomainfrom
cursor/mcp-server-card-well-known-3245
Draft

Publish MCP Server Card for HTTP discovery (/.well-known/mcp/server-card.json)#37
baanish wants to merge 1 commit intomainfrom
cursor/mcp-server-card-well-known-3245

Conversation

@baanish
Copy link
Copy Markdown
Owner

@baanish baanish commented Apr 18, 2026

Summary

Publishes an MCP Server Card at /.well-known/mcp/server-card.json for agent discovery, matching the implementation skill.

What changed

  • Static export: Added public/.well-known/mcp/server-card.json so Next static export copies it to out/.well-known/mcp/server-card.json. The document includes:
    • SEP-2127 fields: $schema, reverse-DNS name, version, title, description, websiteUrl, repository, and remotes (streamable HTTP + placeholder /mcp URL and supported protocol version).
    • Discovery-friendly fields from the skill: serverInfo (name, version), top-level endpoint, and capabilities (tools, resources, prompts all false for this static viewer product).
  • npm run preview: scripts/serve-export.mjs adds CORS + Cache-Control for that path and handles OPTIONS preflight.
  • Self-hosted server: selfhosted/server.ts serves the same file with matching headers before static fallback.
  • Tests: Vitest asserts the committed JSON parses and contains the expected keys.
  • README: One-line note with link to SEP-2127.

Notes

  • The streamable HTTP url / endpoint point at https://agent-render.com/mcp as a placeholder consistent with the skill’s /mcp example; there is no MCP transport implementation in-repo today. Capabilities are explicitly false so clients do not assume tool/resource/prompt surfaces exist without a live server.
Open in Web Open in Cursor 

Add static JSON aligned with SEP-2127 (name, version, remotes) plus
serverInfo, endpoint, and capabilities for discovery validators.
Serve with CORS and short cache from preview and self-hosted static paths.
Add Vitest guard for committed card shape and note in README.

Co-authored-by: Aanish Bhirud <baanish@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 18, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5b42eaea-e1be-4efc-8721-72a823a39fd9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/mcp-server-card-well-known-3245

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying agent-render with  Cloudflare Pages  Cloudflare Pages

Latest commit: 653a985
Status: ✅  Deploy successful!
Preview URL: https://ec05aa6f.agent-render.pages.dev
Branch Preview URL: https://cursor-mcp-server-card-well.agent-render.pages.dev

View logs

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants