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
- JSON-RPC 2.0 over stateless streamable HTTP.
- Read methods need no credentials.
- Orders settle in crypto or x402 on base.
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
| Method | Returns |
|---|---|
initialize | protocol version and server capabilities |
tools/list | every tool below, with its input schema |
tools/call | the result of one tool |
Tools
| Tool | Purpose |
|---|---|
list_plans | the full catalog: plans, specs and prices |
list_locations | 42 datacenters with country, tier and premium |
list_coins | accepted coins, chains and networks |
quote | a live price for one plan, term and location |
check_payment | whether a transaction hash has paid an address |
create_order | reserve 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.