Connect to the MCP server
Connect an agent
Section titled “Connect an agent”Point a compatible MCP client at https://mcp.aivikings.ai/mcp, complete OAuth in the browser, then make a read-only availability check before allowing purchases. MCP lets the client discover the tool list and call only the operations you authorize, while the connected AiVikings.ai account remains the source of customer identity and prepaid balance.
Start with get_current_user, get_prepaid_balance, or check_single_domain_availability. These are read-only tools. Do not start with registration, renewal, nameserver changes, DNS writes, or transfers until the connection, account, and approval controls are clear.
Claude Desktop
Section titled “Claude Desktop”In Claude Desktop, open Settings, choose Customize, then Connectors, and select Add custom connector. Enter this server URL:
https://mcp.aivikings.ai/mcpClaude opens the AiVikings.ai authorization page. Sign in and approve the requested access. The AiVikings tools appear after authorization.
For a Claude Desktop setup that accepts a configuration file, the remote server entry is:
{ "mcpServers": { "aivikings": { "type": "http", "url": "https://mcp.aivikings.ai/mcp" } }}Do not add a static bearer token or custom authorization header to this entry. The server publishes OAuth metadata and the client completes the authorization flow. If your Claude client offers a hosted client metadata option, use that supported option rather than manually constructing OAuth requests.
Claude Code
Section titled “Claude Code”Add the remote MCP server from a terminal:
claude mcp add --transport http aivikings https://mcp.aivikings.ai/mcpRun claude mcp list, then use /mcp in Claude Code to finish authorization when prompted.
The command registers a remote HTTP MCP server called aivikings. The first protected tool call starts the browser authorization flow if needed. Use claude mcp list to verify that the server is configured before diagnosing tool permissions or account access.
ChatGPT connector
Section titled “ChatGPT connector”In ChatGPT developer mode, open Settings, then Security/login, then Plugins. Create a plugin with this server URL:
https://mcp.aivikings.ai/mcpChoose OAuth authentication and complete the AiVikings.ai sign-in and approval flow. See the ChatGPT setup guide for the full interface flow.
The plugin label is only for your ChatGPT workspace. The server URL must be exactly https://mcp.aivikings.ai/mcp. Do not use the REST API base URL as a connector URL, and do not paste an API token into the connector form.
Generic MCP clients
Section titled “Generic MCP clients”Use a Streamable HTTP MCP connection to this endpoint:
{ "mcpServers": { "aivikings": { "type": "http", "url": "https://mcp.aivikings.ai/mcp" } }}Configuration field names differ by client, but the required server value is always the same HTTPS endpoint. Select the client’s HTTP or Streamable HTTP transport and allow it to use the server’s OAuth metadata. A client that supports protocol discovery can call initialize and tools/list before it has an account token, but protected account and domain tools require authorization.
What OAuth does
Section titled “What OAuth does”The client reads the MCP server metadata, registers an OAuth client when needed, and sends you to AiVikings.ai to authorize your account. You sign in to the appropriate account, review the requested access, and approve it. The client receives tokens after approval and uses them for protected tool calls. You do not paste an API token into the MCP configuration.
The browser returns you to the client after authorization. If the client asks to reconnect or refresh tools, complete that step before opening a chat. The account that completes OAuth is the account whose domain holdings, balance, contacts, and authorized actions the tools will use.
Verify the connection
Section titled “Verify the connection”Ask the connected agent to run the read-only check_single_domain_availability tool for a domain, such as example.com. A plain-language prompt is: “Check whether example.com is available in USD. Do not register it.” The tool requires domain, accepts optional currency, and returns a one-item domains array with availability, pricing, premium status, environment, and provider information.
Then ask: “Which AiVikings.ai account is connected?” The read-only get_current_user tool returns the authenticated state plus the customer id, name, and email. Confirm this account before any paid or write action. Discovery alone does not authorize account tools or domain purchases.
Common connection problems
Section titled “Common connection problems”The client cannot reach the server. Confirm the URL is exactly https://mcp.aivikings.ai/mcp, with HTTPS and no trailing space. Do not use https://api.aivikings.ai/v1, which is the REST API base URL rather than the MCP server.
The tools list is empty. Refresh the server connection or reconnect it, then ask the client to discover tools again. A protocol-capable client can use initialize and tools/list without an account token, so this is a connection or client configuration issue rather than a domain permission issue.
Authorization fails or the wrong account appears. Restart the OAuth flow and sign in to the intended AiVikings.ai account. If your client shows a cached connection, disconnect it before authorizing again. Do not solve an OAuth failure by pasting a bearer token into the MCP configuration.
Read tools work but a purchase is blocked. Check the current account, prepaid balance, user confirmation setting, contact readiness, and the exact domain price or premium status. Registration and renewal spend credit. A client or application may deliberately require confirmation before these calls.
A managed workspace blocks the connector. A Claude or ChatGPT workspace owner may need to allow custom connectors or plugins. Ask the workspace administrator to approve the exact MCP endpoint rather than using an unofficial proxy.
For tool inputs, return values, and purchase safeguards, use the MCP tools reference.