nenoDevelopers
⌘K
v1

MCP · Bills

Get bill status

READget_bill_status

Looks up one bill, or the most recent one, and returns its status and upload date. Supplier, amount, document date and file type are added once an accountant has reviewed it.

Scope
bills:read
Read bills, receipts and stored documents
Permission
neno.viewDocuments
Your role in the company must include it
Annotations
readOnlyHint trueidempotentHint truedestructiveHint false

Description for models

Look up the status and details of a specific bill or the most recent bill. Returns the status and file type, and the supplier, amount and date only once an accountant has reviewed it; before that, the status is the answer. Use this when the user asks about a receipt or invoice they uploaded — e.g. "did my receipt process?", "what was the total?", "show my last upload". The bill_id can be found in the conversation history from the upload turn.

Sent verbatim in tools/list. It's written for the model, so it says when to use the tool.

Arguments

bill_idstring

The bill ID to look up. On WhatsApp, prefer the bill ID from the upload turn in the conversation. Omit it to get the company's most recent bill, which is not necessarily the one the user just sent.

Added by the server

On every tool that acts on one company
workspacestring

The id of the company this applies to. This connection covers a single company, which is filled in for you, so you can leave this out.

Result

text
Success. The answer as plain text in content[0].text, starting with Company: and the company name.
isError
Refused or failed. A missing permission, an invalid argument or a server failure sets isError: true. The text says what went wrong and what to tell the user.
input
Company needed. With several companies and no workspace argument, the server asks which company the call is for. A client that can't ask gets an error that lists the companies.
POST /mcp · tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_bill_status",
    "arguments": {
      "bill_id": "3d8a5f12-6b90-4c7e-a1f4-0e29b7c6d853"
    }
  }
}
Example resultHand-written
content[0].text
Company: Studio Veld BV
 
Bill: Drukkerij Hendriks
Status: filed in the bookkeeping
Uploaded: 2026-09-18
Amount: 1815.00 EUR
Document date: 2026-09-17
Type: INVOICE
File: application/pdf

Tools return plain text with no output schema. This example follows the tool's real format, but the values are made up.