Bill pay is a pilot. Contact us to turn it on for your business.
Install
@conto_finance/sdk 0.11.0 or later, or @conto_finance/mcp-server 0.8.0 or later.How it works
1
The owner turns bill pay on for the agent
In Conto, open Bill pay and choose Turn on next to the agent under Agents that can pay
bills. Only an owner can change this. The owner also adds suppliers and their bank details.
2
The agent sends a bill
One PDF, PNG, JPEG or WebP file under 2 MB. Conto reads the supplier, invoice number, amount and
due date off it.
3
Conto checks it
The supplier must be one the owner confirmed, with a confirmed bank account. Conto also screens
the supplier against sanctions lists, stops a bill it has already seen, and applies the agent’s
own policies, budgets and limits.
4
The owner approves
A bill over the owner’s pay-without-asking amount waits in the Inbox. After approval, the
owner can still undo the payment for a short time, until the bank sends it.
5
The supplier is paid
The bill moves to
PAID when the bank confirms it. If the supplier’s bank sends the payment
back, the bill moves to RETURNED and Conto puts that supplier on hold.Send a bill
Sending needspayments:request. Reading bills and suppliers needs transactions:read. A standard
agent SDK key has both. See authentication.
next says where the bill is now, in one sentence. reviewReasons lists why a bill needs the owner,
such as a supplier the owner hasn’t confirmed.
Follow a bill
steps runs from upload to paid. Each step is done, current, waiting, stopped or
upcoming. A current step’s at is when it ends, for example the end of the undo window.
conto.bills.list({ status }) returns the bills this agent sent, newest first, 50 at most. An agent
only sees its own bills.
Check suppliers
PENDING_CONFIRMATION until the owner confirms it, PAYABLE once they have, and
HELD when a payment came back or the sanctions screen stopped it. heldReason says why. Only the
owner adds suppliers and bank details, in Conto.
Use it from MCP
The@conto_finance/mcp-server package lists the bill pay tools when you set CONTO_BILL_PAY=true
next to your agent SDK key. See install.
submit_bill (a path to a local file), list_bills, get_bill and
list_bill_suppliers. See MCP tools.
Errors
Every error body has
error, a sentence you can show the owner. The routes are in the
interactive API docs under Bill pay agent.