---
title: "Name.ai Developer Portal — API Docs, OpenAPI Spec, MCP Server"
description: "Name.ai developer portal: Name.ai API docs (OpenAPI 3.1 spec), the Name.ai MCP server for Claude and other agents, and OAuth for authenticated access. No account required to start."
url: https://name.ai/developers
---

For developers and agents

# Name.ai developer portal

This developer portal is free and public — no signup required to start building against the Name.ai API docs, the Name.ai MCP server, or the OpenAPI spec. Signing in via OAuth additionally unlocks real marketplace pricing on domain search.

### Name.ai MCP server

Domain search/availability, WHOIS lookup, and TLD pricing/requirements as MCP tools. Works with any MCP client — Claude, Cursor, and others.

[MCP server docs →](https://name.ai/developers/mcp)

### Name.ai API docs (OpenAPI)

The same endpoints as plain REST, documented as an OpenAPI 3.1 spec, for anything that isn’t speaking MCP.

[API docs →](https://name.ai/developers/api)

### Name.ai API authentication

OAuth 2.1 with PKCE. Optional — every endpoint works without it. Signing in additionally unlocks real marketplace prices.

[Read the auth flow →](https://name.ai/developers/auth)

### Site map for agents

A curated, machine-readable overview of name.ai — what it is, and where to start.

[View llms.txt →](https://name.ai/llms.txt)

## Connect from your IDE or agent

The MCP server is remote — no install, no API key. Add it to any MCP client (Claude Code, Claude Desktop, Cursor, and others) with this config:

```
{
  "mcpServers": {
    "name-ai": {
      "type": "http",
      "url": "https://nameai-mcp.h.namekart.com/mcp"
    }
  }
}
```

Or with the Claude Code CLI:

```
claude mcp add --transport http name-ai https://nameai-mcp.h.namekart.com/mcp
```

Tools available: domain search/availability, WHOIS lookup, TLD registration pricing, and TLD registration requirements. To see real marketplace prices on domain searches, authenticate per [auth.md](https://name.ai/auth.md). The server is open source — source, `AGENTS.md`, and agent plugin manifest at [github.com/namekart/nameai\_mcp](https://github.com/namekart/nameai_mcp). Pricing for agents: [/pricing](https://name.ai/pricing) (HTML) or [/pricing.md](https://name.ai/pricing.md) (markdown).

## Every developer resource, on one page

Two agents integrating against name.ai reported the same friction — the picture had to be assembled from several pages. This is the whole surface in one table.

| Resource | Where |
| --- | --- |
| API referenceEndpoints, conventions, curl examples | [/developers/api](https://name.ai/developers/api) |
| OpenAPI 3.1 specThe machine-readable contract | [/openapi.json](https://name.ai/openapi.json) |
| MCP serverSetup and tool reference | [/developers/mcp](https://name.ai/developers/mcp) |
| MCP manifestAlso extensionless at /.well-known/mcp | [/.well-known/mcp.json](https://name.ai/.well-known/mcp.json) |
| MCP server card | [/.well-known/mcp/server-card.json](https://name.ai/.well-known/mcp/server-card.json) |
| AuthenticationOAuth 2.1 + PKCE, optional | [/developers/auth](https://name.ai/developers/auth) |
| auth.mdThe canonical agent\_auth document | [/auth.md](https://name.ai/auth.md) |
| Protected-resource metadataRFC 9728 | [/.well-known/oauth-protected-resource](https://name.ai/.well-known/oauth-protected-resource) |
| Authorization-server metadataRFC 8414 | [/.well-known/oauth-authorization-server](https://name.ai/.well-known/oauth-authorization-server) |
| Batch endpointGET it for the catalogue; POST up to 20 reads | [/api/batch](https://name.ai/api/batch) |
| Natural-language searchNLWeb; JSON or SSE | [/ask](https://name.ai/ask) |
| Schema mapIndexes the structured-data feeds | [/schemamap.xml](https://name.ai/schemamap.xml) |
| Marketplace feedOne schema.org Product per line | [/feeds/listings.jsonl](https://name.ai/feeds/listings.jsonl) |
| Pricing, agent-readablePer-TLD table, commissions, limits | [/pricing.md](https://name.ai/pricing.md) |
| Site map for agentsScoped: /developers/llms.txt, /api/llms.txt | [/llms.txt](https://name.ai/llms.txt) |
| AI catalogEvery agentic resource here | [/.well-known/ai-catalog.json](https://name.ai/.well-known/ai-catalog.json) |
| A2A agent card | [/.well-known/agent-card.json](https://name.ai/.well-known/agent-card.json) |
| Agent skills indexArtifacts with digests | [/.well-known/agent-skills/index.json](https://name.ai/.well-known/agent-skills/index.json) |
| Sandbox testingPartner API; environment is set per credential | [/syndicate-partners/sandbox](https://name.ai/syndicate-partners/sandbox) |
| JavaScript SDKnpm install nameai-sdk | [https://www.npmjs.com/package/nameai-sdk](https://www.npmjs.com/package/nameai-sdk) |
| Python SDKpip install nameai | [https://pypi.org/project/nameai/](https://pypi.org/project/nameai/) |
| Source, AGENTS.md, plugin.jsonAgent configs and the plugin manifest | [https://github.com/namekart/nameai\_mcp](https://github.com/namekart/nameai_mcp) |

## Testing against a sandbox

The public read endpoints need no sandbox — they are free, unauthenticated and safe to call as often as the rate limit allows. The Partner API has one: sandbox and live are selected by the **environment on your credential**, not by a separate hostname, so the same `/api/partner/v1` paths serve both. Sandbox credentials are issued on approval with no manual review, and sandbox orders fire real signed webhooks. [Sandbox testing guide](https://name.ai/syndicate-partners/sandbox).

## Raw artifacts

The files themselves, for a client that already knows what it wants: [/openapi.json](https://name.ai/openapi.json), [/.well-known/mcp.json](https://name.ai/.well-known/mcp.json), [/auth.md](https://name.ai/auth.md), [/llms.txt](https://name.ai/llms.txt), and the section-scoped [/developers/llms.txt](https://name.ai/developers/llms.txt) · [/api/llms.txt](https://name.ai/api/llms.txt).

Name.ai Developer Portal — API Docs, OpenAPI Spec, MCP Server

---

Markdown representation of https://name.ai/developers. The same URL returns HTML to any client that asks for `text/html`. Site map for agents: https://name.ai/llms.txt