DEVELOPERS · AGENT API & MCPAGENT API & MCP

Agent API and MCP
reference

Read-only endpoints for plan comparison, domain search and checkout preparation. Anything that changes an account stays behind customer approval.

⌘K⌘K

View as Markdown llms.txt

BASE URLS

Catalog API: https://onenetservers.net/api/agent
MCP server: https://onenetservers.net/api/mcp
Auth: None for read-only calls
Format: JSON · JSON-RPC 2.0 for MCP

● All public surfaces operational

QUICK START

Use the public surfaces in the right order.

Fetch the catalog

Structured plans and prices in one call.

GET /api/agent/catalog

Check a domain

Availability and alternatives, without touching a cart.

GET /api/agent/domain-search

Connect MCP

Give tool-using agents list, search and requirements tools.

POST /api/mcp · tools/list

ENDPOINTS

Endpoint reference

On this page: GET /domain-search ⌄

GET/api/agent/domain-search

Checks public availability for a brand term or exact domain without changing any cart. Returns alternatives when the exact match is taken.

PARAMETERS

querystringrequired

Brand term or full domain, e.g. adirestudio.ng

tldstringoptional

Limit to one extension, e.g. .ng

limitintegeroptional

Alternatives to return, default 5

RETURNS

domain, available, price (NGN, GBP, USD), alternatives[], checkout_url. No customer data and no state changes.

cURL    JavaScript    Python

curl https://onenetservers.net/api/agent/\
  domain-search -G \
  --data-urlencode "query=adirestudio" \
  --data-urlencode "tld=.ng"

200  Response
{
  "domain": "adirestudio.ng",
  "available": true,
  "price": { "ngn": 0, "gbp": 0, "usd": 0 },
  "alternatives": ["adirestudio.com.ng"],
  "checkout_url": "https://onenetservers.net/..."
}Prices shown as 0 are placeholders in this example.

MCP

MCP tools

Call tools/list to discover them at runtime. Every tool is read-only; none creates orders or changes services.

TOOLINPUTSRETURNSSIDE EFFECTS

search_domainsquery, tlds[], limitAvailability, price and alternatives for a brand or domainAvailability + alternativesNone

list_productscategory, currency, max_pricePlans with specs and prices in NGN, GBP or USDPlans and prices by categoryNone

checkout_requirementsproduct_id, domainWhat the customer must supply and approve before checkoutWhat a customer must provideNone

ERRORS

Status codes and safe messages

Show customers the plain-English message; log the code. Never expose billing-platform internals.

CODELABELWHAT TO TELL THE CUSTOMERMEANING

200OKOK · Request succeeded.

400Bad requestBad request · A parameter is missing or invalid.

404Not foundNot found · Unknown product or endpoint.

429Slow downSlow down · Too many requests; retry after the Retry-After header.

503Temporarily unavailableTemporarily unavailable · Pricing is refreshing; try again shortly.

PRODUCTION CHECKLIST

The minimum bar for
shipping an agent

These checks keep an integration useful for customers without turning discovery into a billing shortcut.

✓Treat every discovery surface as read-only.

✓Require customer approval before any checkout or account change.

✓Validate domain requirements before collecting billing details.

✓Handle billing-platform hiccups with generic, user-safe messages.

✓Use MCP for tool calls, never for hidden order creation.

Changelog

Sep 2026checkout_requirements tool added to MCP

Aug 2026Prices returned in NGN, GBP and USD

Jul 2026Public catalog and domain-search endpoints launched

Building something bigger?

Partners and resellers can request higher limits and early access to new tools. Talk to an engineer in Lagos or London.

Talk to an engineer

Agent API and MCPreference