Tool · Invoices

get_invoice

Get a single invoice by ID, including line items.

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 #

idintegerRequired

Response #

200 · application/json

invoiceobject

idinteger

invoice_numberstring

statusstring

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

totalobject

valuestring

currencystring

due_datestring · null

datestring · null

line_itemsarray<object>

idinteger

descriptionstring

amountobject

typestring

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

{ "invoice": { "id": 4821, "invoice_number": "string", "status": "Unpaid", "total": { "value": "24.00", "currency": "BGN" }, "due_date": "2026-06-15", "date": "2026-06-15", "line_items": [ { "id": 4821, "description": "string", "amount": { "value": "24.00", "currency": "BGN" }, "type": "Hosting" } ] } }