Tool · Invoices

find_invoices_by_relation

Find the caller's invoices that include a charge for a specific hosting service (rel_type=Hosting) or domain (rel_type=Domain). rel_id is the integer service id or domain id. Returns up to 50 matching invoices, newest first.

Read-onlyIdempotentscope read:invoices

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:invoices scope — View your invoices and billing history. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

rel_typestringRequired

Must be exactly "Hosting" or "Domain".

rel_idintegerRequired

Hosting id (for Hosting) or domain id (for Domain).

Response #

200 · application/json

invoicesarray<object>

idinteger

invoice_numberstring

statusstring

One of: Unpaid Paid Cancelled Refunded Collections Draft Payment Pending Overdue

totalobject

valuestring

currencystring

due_datestring · null

datestring · null

truncatedboolean

limitinteger

Errors #

Result	When
{ "error": "invalid_rel_type" }	See the tool description for when this result is returned.
{ "error": "invalid_rel_id" }	See the tool description for when this result is returned.

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": "find_invoices_by_relation", "arguments": { "rel_type": "string", "rel_id": 4821 } } }

{ "invoices": [ { "id": 4821, "invoice_number": "string", "status": "Unpaid", "total": { "value": "24.00", "currency": "BGN" }, "due_date": "2026-06-15", "date": "2026-06-15" } ], "truncated": true, "limit": 1 }