Purchasing

List suppliers

purchasing_list_suppliers · Reads only · Markdown

Suppliers by name, each with what is owed to them on open bills and how many orders are open.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which suppliers do we owe money to right now?

Your agent callspurchasing_list_suppliersFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "suppliers": [
    {
      "supplier_id": 4101,
      "name": "Nordstahl Küchentechnik GmbH",
      "contact_name": null,
      "email": "orders@nordstahl.example",
      "phone": null,
      "address": "Hafenstraße 8\n24937 Flensburg\nGermany",
      "tax_id": null,
      "currency": "EUR",
      "terms_days": 30,
      "account": "5000",
      "notes": null,
      "iban": null,
      "bic": null,
      "country": null,
      "archived": false,
      "owed": {},
      "open_orders": 1
    }
  ]
}

Use it when

Someone asks who the business owes, or a supplier's id is needed.

What it does

Suppliers by name, each with what the business owes them on open bills (per currency) and how many orders are open. Search by name, contact or email.

What comes back

suppliers: each with its supplier_id, name, contact, currency, terms, what is owed per currency and open orders. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
searchstringUp to 100 characters.
include_archivedbooleanDefault: false.

The call

Over MCP, call purchasing_list_suppliers on https://api.conecto.chat/mcp/purchasing. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/purchasing_list_suppliers \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md