This is the official Model Context Protocol (MCP) server for Headless Domains.
It allows AI agents (like Claude, Cursor, and custom agentic frameworks) to natively search for and register decentralized agent identities.
The Model Context Protocol (MCP) provides two main ways for an AI agent to connect to this server:
This is the cloud-hosted web server you are currently looking at! It is the best method for widespread adoption because modern agents (like Cursor, Windsurf, or web-based AI tools) can connect directly over the internet without users needing to download or install any Python code.
Endpoint URL: https://mcp.headlessdomains.com/sse
Note: If the user wishes to register domains or sync bios, they must pass their HEADLESSDOMAINS_API_KEY as an environment variable or header when connecting their agent.
The AI agent literally runs Python on the user's laptop to start the server locally in the background. This is currently required for Claude Desktop. It is secure, but requires the user to install Python and clone the GitHub repository.
Command: mcp run server.py