Tool · Domains

get_domain

Get a single domain by ID, including status and expiry date.

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 #

idintegerRequired

Response #

200 · application/json

domainobject

idinteger

domain_namestring

statusstring

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

registration_datestring · null

expiry_datestring · null

next_due_datestring · null

recurring_amountobject

valuestring

currencystring

first_payment_amountobject

valuestring

currencystring

auto_renewboolean

id_protectionboolean

dns_managementboolean

Errors #

Result	When
{ "error": "not_found" }	The requested item does not exist, or it belongs to another account. Cross-account IDs are indistinguishable from missing ones by design.

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": "get_domain", "arguments": { "id": 4821 } } }

{ "domain": { "id": 4821, "domain_name": "example.com", "status": "Active", "registration_date": "2026-06-15", "expiry_date": "2026-06-15", "next_due_date": "2026-06-15", "recurring_amount": { "value": "24.00", "currency": "BGN" }, "first_payment_amount": { "value": "24.00", "currency": "BGN" }, "auto_renew": true, "id_protection": true, "dns_management": true } }