Tool · Domains

list_domains

List the caller's registered domains with expiry dates.

Read-onlyIdempotentscope read:domains

Invoked over the MCP transport with a tools/call request naming this tool.

Authorization #

Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:domains scope — View your registered domains and their details. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

This tool takes no parameters.

Response #

200 · application/json

domainsarray<object>

idinteger

domain_namestring

statusstring

One of: Active Expired Pending Pending Registration Pending Transfer Transferred Away Cancelled Grace Fraud

expiry_datestring · null

recurring_amountobject

valuestring

currencystring

first_payment_amountobject

valuestring

currencystring

curl https://mcp.jethost.bg/mcp \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_domains", "arguments": [] } }

{ "domains": [ { "id": 4821, "domain_name": "example.com", "status": "Active", "expiry_date": "2026-06-15", "recurring_amount": { "value": "24.00", "currency": "BGN" }, "first_payment_amount": { "value": "24.00", "currency": "BGN" } } ] }