Skip to content

MCP signal detected but no /.well-known/mcp.json discovery manifest visible

This check looks for a /.well-known/mcp.json file, a small discovery file that tells AI tools like Claude Desktop, ChatGPT, Cursor and Continue how to connect to your MCP (Model Context Protocol) server. MCP signals were detected on this site, but no such manifest file was found.

Why this matters

The MCP specification has evolved to include discovery mechanisms such as well-known manifest files, and some MCP clients may use them to find servers. Without a manifest, those clients may not discover your MCP server automatically, even if the server itself works well. Check the current MCP specification and the documentation of the clients you care about, as this area is changing quickly.

How to fix it

Your engineering team should publish /.well-known/mcp.json describing your server's name, version, transport method, capabilities and authentication, and add a <link rel='mcp'> tag to your page's <head>. The specification is documented at modelcontextprotocol.io. Budget about a day for a developer to write and test it.

Turn website findings into an action plan

Create an account to start a Full Audit of your website, with supporting evidence and a prioritised action plan.

Start Full Audit