Public API for querying ENS domain data. All endpoints return JSON.
Pass your key via the X-API-Key header. Sign up to get a key with 1,000 free credits.
Pay per request using the MPP protocol. No account needed — pay directly from your wallet.
No authentication is needed to try the API - unauthenticated requests are limited to 5 per minute. Sign up for unlimited access.
/api endpoints. You can call these from any origin.The enswhois MCP server exposes these APIs as agent tools, so MCP clients (Claude Desktop and others) can call ENS lookups directly. It is also the endpoint advertised by enswhois.eth's ENSIP-26 agent-endpoint[mcp] record.
Transport: Streamable HTTP (the current MCP spec transport). Clients POST JSON-RPC to the URL above; GET/DELETE are not used (stateless server).
The tools are thin wrappers over this REST API and reuse its tiers exactly. Pass an enswhois API key via the X-API-Key header (or Authorization: Bearer <key>) on the connection. Without a key, requests are rate-limited to 5 per minute. Sign up for a key.
| Tool | Description | REST endpoint |
|---|---|---|
| whois | Look up an ENS name: ownership, resolver, expiry, availability | /whois/:name |
| list_domains | Names associated with an address (optional type role filter) | /address/:address/domains |
| lookup_namehash | Resolve a namehash back to its domain | /lookup-namehash/:hash |
| lookup_labelhash | Find domains matching a labelhash | /lookup-labelhash/:hash |
| get_text_record | Read a single ENS text record | /domain/:name/records/text/:key |
| list_text_records | All current resolver records (text, addresses, contenthash) | /domain/:name/records |
| is_erc8004_agent | ERC-8004 agent status (ENSIP-25 record + on-chain Adapter8004 check) | /domain/:name/agent |
| agent_profile | ENSIP-26 agent profile: agent-context + agent-endpoint[mcp/a2a/web], plus ERC-8004 status | /domain/:name/records + /domain/:name/agent |
Add the server to your MCP client configuration:
{
"mcpServers": {
"enswhois": {
"url": "https://mcp.enswhois.com/mcp",
"headers": { "X-API-Key": "your-key-optional" }
}
}
}