How to make your MCP server discoverable by other agents

Why It Matters

Making your MCP server discoverable is crucial for enhancing its visibility and usability among AI agents. By ensuring that your server is properly indexed, you allow other agents to connect and utilize the tools and resources you provide. This can lead to increased collaboration and functionality within the AI ecosystem.

How the Index Sees Your Resource

Wellknown observes the status of MCP servers and their discoverability through various metrics. The observed statuses include:

• live: The latest check succeeded within 24 hours.
• recently observed: A success within 7 days but stale or failing.
• unavailable: Two or more consecutive failures and no success in 7 days.
• unknown: Nothing to check or never checked.

Your server's visibility in the Wellknown index is determined by these observed statuses, which reflect its reliability and accessibility to other agents.

Step-by-Step How-To

To make your MCP server discoverable, follow these steps:

1. Publish on npm/PyPI: Ensure your MCP server is published with the appropriate keywords that facilitate discovery.
2. Register in the Official MCP Registry: You need to submit your server to the MCP registry at registry.modelcontextprotocol.io.
3. Expose a Remote Endpoint: Make sure your MCP server has a remote HTTP endpoint that can be accessed by other agents.
4. Claim the Record: Prove control of your record by using one of the following claim proofs:
   • A DNS TXT record at _wellknown.YOUR-DOMAIN.
   • A verification file at https://YOUR-DOMAIN/.well-known/wellknown-verify.txt.
   • A .wellknown-verify file at the root of your repository.
5. Add the Badge: Include a badge on your website or documentation that indicates your server is discoverable.

What Changes Once It Is Done

Once you have completed these steps, your MCP server will be indexed by Wellknown, allowing it to be discoverable by other agents. This means that your server will appear in search results, and other agents can interact with it, enhancing its utility and reach within the AI community.

Common Mistakes

When making your MCP server discoverable, avoid these common pitfalls:

• Incorrect Keywords: Failing to use the right keywords when publishing can hinder discoverability.
• Neglecting Claim Proofs: Not providing valid claim proofs can result in your server not being indexed.
• Endpoint Accessibility: Ensure that your remote endpoint is accessible; if it is down or misconfigured, it will affect your server's status.
• Ignoring Status Checks: Regularly check the status of your server using the Wellknown API to ensure it remains live and accessible.

By following these guidelines, you can effectively make your MCP server discoverable by other agents, fostering greater collaboration and resource sharing in the AI landscape.

Note: The data is a snapshot as of 2026-09-09T08:29:19.810Z.