Skip to content

Add .well-known/mcp.json for MCP server discovery#245

Merged
Scottcjn merged 1 commit into
Scottcjn:mainfrom
IcanBENCHurCAT:main
Jul 1, 2026
Merged

Add .well-known/mcp.json for MCP server discovery#245
Scottcjn merged 1 commit into
Scottcjn:mainfrom
IcanBENCHurCAT:main

Conversation

@IcanBENCHurCAT

Copy link
Copy Markdown
Contributor

This adds a .well-known/mcp.json file to enable auto-discovery by registries like Smithery.ai, Glama, and others.

@FakerHideInBush FakerHideInBush 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.

Two blockers and one convention issue before merging:

1. No transport endpoint URL — clients that discover this file have no way to connect

The .well-known/mcp.json manifest as defined by the model-context-protocol specification requires a transport descriptor so that MCP clients know how to actually reach the server. This file includes branding metadata (name, description, homepageURL, license) but omits the critical endpoint (or equivalent transport) field.

Without an endpoint, a client that fetches https://rustchain.org/.well-known/mcp.json can render a display name and icon, but cannot establish an MCP session. The discovery file becomes non-functional advertising rather than a machine-readable connection descriptor.

At minimum add a transport section, for example:

{
  "mcp": {
    "server": {
      "name": "rustchain-mcp",
      "transport": [
        {
          "type": "sse",
          "url": "https://rustchain.org/mcp/sse"
        }
      ]
    }
  }
}

2. External icon URL (https://rustchain.org/images/logo.png) creates a fragile dependency

"icons": [
  {
    "src": "https://rustchain.org/images/logo.png",
    "type": "image/png"
  }
]

The icon URL is an absolute remote reference. This means:

  • If rustchain.org is temporarily down, clients that validate the icon at discovery time will fail or degrade.
  • If the image is ever moved or renamed, every cached discovery response breaks with no way to update it retroactively.

Better to keep a copy of the icon in the repo (e.g. static/logo.png) and use a relative path "src": "/images/logo.png" that is stable as long as the site is up, or reference the raw GitHub content URL so the image is version-pinned to this repo's assets:
https://raw.githubusercontent.com/Scottcjn/rustchain-mcp/main/static/logo.png

3. Missing newline at end of file

The diff shows \ No newline at end of file. POSIX text files should end with a newline; some JSON parsers and CI tools (e.g. prettier, editorconfig checks) will flag this. Add a trailing newline to the file.

@Scottcjn Scottcjn merged commit 3175a12 into Scottcjn:main Jul 1, 2026
6 checks passed
@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown

RTC Reward

This merged PR earned 5 RTC — sent to IcanBENCHurCAT.

RustChain Bounty Program

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.

3 participants