Add .well-known/mcp.json for MCP server discovery#245
Conversation
FakerHideInBush
left a comment
There was a problem hiding this comment.
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.orgis 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.
RTC RewardThis merged PR earned 5 RTC — sent to |
This adds a .well-known/mcp.json file to enable auto-discovery by registries like Smithery.ai, Glama, and others.