MCP server

Short answer. NyxHost exposes the catalog over the Model Context Protocol (JSON-RPC 2.0, stateless streamable HTTP) so an agent can list plans, price an order and place one without a human in the loop.

TL;DR

Endpoint

POST JSON-RPC 2.0 to /mcp/. The transport is stateless: no session id, no handshake, no server-side state between calls.

curl -sX POST /mcp/ \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Methods

MethodReturns
initializeprotocol version and server capabilities
tools/listevery tool below, with its input schema
tools/callthe result of one tool

Tools

ToolPurpose
list_plansthe full catalog: plans, specs and prices
list_locations42 datacenters with country, tier and premium
list_coinsaccepted coins, chains and networks
quotea live price for one plan, term and location
check_paymentwhether a transaction hash has paid an address
create_orderreserve a server once a payment is confirmed

Discovery

Machine-readable descriptions: agent.json · openapi.json · mcp.json · ai.txt

Authentication

Read tools are open. Tools that create or fund an account take a bearer token issued by POST /api/agent/account; there is no signup form and no identity document.

Status

The endpoint is published for agent partners. If a call returns 404, the server is not enabled for your account yet — use the checkout or email us and we enable it.

Agent API overview mcp.json