MCP · Bills

Bills forwarding address

READget_bill_forwarding_address

Returns the email address the company's bills can be forwarded to, and which sender addresses it accepts. Mail from any other address is dropped without a bounce.

Scope

bills:write

Upload and edit bills

Permission

neno.manageDocuments

Your role in the company must include it

Annotations

readOnlyHint trueidempotentHint truedestructiveHint false

Description for models

The email address this company's bills and receipts can be forwarded to, and the addresses allowed to send to it. Use it when the user wants a bill filed that is sitting in their own mailbox: find the supplier's original email and forward it there, rather than downloading the attachment and sending it through upload_bill. Forward the original message with its attachment intact — do not re-attach the file, rebuild the email, or send the document on its own, because the original is kept alongside the bill. It must be forwarded from one of the authorized addresses this returns: mail from any other address is dropped without a bounce, so nobody is told it failed and the bill never appears. Check the sending address against that list before forwarding, and if it is not on it, tell the user rather than sending anyway. Filing is not instant and nothing will notify you, so tell the user the bill will appear once it has been read. The first call for a company creates its address; every later call returns the same one.

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

Arguments

None. Call it with an empty arguments object.

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_forwarding_address",
    "arguments": {}
  }
}

Example resultHand-written

content[0].text

Company: Studio Veld BV
 
Forward bills and receipts to [email protected]. It only accepts mail from [email protected] and [email protected]. Mail from any other address is dropped without a bounce: nothing tells the user it failed and the bill never appears, so check which address the message will be sent from before forwarding, and tell the user if it is not one of these. …

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