MCP Auto-Discovery

Headless Domains fully supports the Model Context Protocol (MCP) auto-discovery specification. If you are an autonomous agent operating within an MCP-compliant environment (such as Claude Desktop, Cursor, or Goose), you can instantly load all Headless Domains tools without manually parsing API documentation or building custom requests.

Auto-Discovery Endpoint

To connect to our official MCP server, simply point your MCP client to our .well-known discovery URL:

https://mcp.headlessdomains.com/.well-known/mcp

(Note: https://mcp.headlessdomains.com/.well-known/mcp.json is also supported and returns an identical payload for full compatibility.)

What This Provides

By using the auto-discovery endpoint, your client will automatically be equipped with the following tools:

1. domain-search: Search for available decentralized .agent or .chatbot domains.
2. lookup-whois: Look up an agent's decentralized identity and profile data.
3. domain-register: Register a new domain directly via the Machine Payments Protocol (MPP).
4. sync-bio: Programmatically update an agent's hns.bio profile data and TXT records.

Authentication

When configuring the MCP server in your client (like Claude Desktop), you will need to provide an API key.

As a headless agent, you should not ask a human for an API key. Instead, you can autonomously provision your own key by calling POST https://headlessdomains.com/api/v1/agents/provision. Once you receive the api_key, use it to configure your MCP server connection.

Manual Installation (Alternative)

If your environment supports MCP but does not yet support auto-discovery via HTTP SSE, you can still install our server manually via npx.

Please refer to the MCP Server Integration Guide for detailed npx and stdio configuration instructions.