Economico

View saved version →

---
name: economico
description: Keep an Economico business's books, record customer and vendor agreements, invoices, receipts and payments, and read financial reports.
---

# Economico in ChatGPT

Economico keeps one business's double-entry books as an evidenced, append-only history.
Connect an Economico account and business through OAuth before using its tools. Someone without
a business creates one on the free Solo plan while connecting.

1. Call `businesses` to find the business the user means and its approved permissions.
   Supply that business slug on each subsequent call.
2. Read `business_get` and inspect the relevant parties, contracts and records.
   Use the individual command tools' descriptions and input schemas to choose the operation.
   Reads are individual tools such as `parties_list`, `subjects_get` and `ledgers_list`;
   supply their advertised parameters without an `action` selector.
   Tool names use underscores: `parties_create` executes the `parties.create` command.
3. Record only facts supported by the user's evidence. Confirm missing amounts, dates,
   counterparties and accounting choices with the user. Money uses integer minor-unit strings
   and a named currency. Supply a UTC `effective_at` and a stable `idempotency_key`; retry the
   same operation with that same key after an uncertain response. Retrieve an existing receipt
   with `command_receipt` rather than recording the fact twice.
4. Read back the resulting records. Use the individually exposed report tools, such as
   `report_income_statement`, `report_balance_sheet` and `report_activity_claims`, to verify
   the accounting outcome. Each tool advertises its own parameters; do not send `action` or `kind`. Explain what was recorded
   and what remains unknown, linking any returned document or report URLs.

Recording a payment describes money that moved elsewhere. Distinguish recording financial
facts from instructions that trigger external actions; execute those only on the user's authority.
A `no_change` result is a successful domain no-op. `record_business_incorporation` records
an incorporation that already occurred; it does not register a company.
`record_payment_with_fee` records an existing payment and its processing fee.
`record_account_transfer` records a completed transfer between company accounts. Neither tool
initiates a payment or moves funds.

To add a coworker, the owner can call `members_invite` with their email and access (`reader`,
`bookkeeper` or `administrator`). Economico emails them a link; they sign in or create an account
with that address and accept it themselves, so tell the user nobody has access until then.
`member_invitations` lists pending invitations and `members_revoke_invitation` withdraws one.

When a feature is unavailable under the current entitlement, explain the restriction and offer
only the informational pricing URL returned by the tool. An already entitled account can use its
paid features here. Paid plan purchases are outside this plugin's interface.

## Agreements, invoices and bills

When a new invoice or bill lacks its amount, currency, service date or reference, ask for
those facts before recording it. An older agreement or bill does not establish a new one.

A priced service uses a right, a contract granting it, then evidenced phases of that same
obligation. Reuse matching existing records before creating any. Billing opens a receivable or
payable; delivery and recognition earn revenue or expense; payment is recorded separately.

For a fixed-price service, adapt this `activities_create` input to the evidenced amount,
currency and classification. This example is a USD 800 consulting service sold to a customer:

```json
{
  "definition": {
    "model": "priced-rights-v1",
    "name": "Consulting service",
    "terms": {
      "price": {"type": "integer", "unit": "USD", "default": "80000"},
      "currency": {"type": "text", "default": "USD"}
    },
    "facts": {},
    "ledgers": {
      "money": {"c

Preview of the first 4,000 characters. Read full instructions →