{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "smartbill.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 982,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 982,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 982,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 982,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.62.184",
          "172.67.138.37",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-22T21:05:02.471Z",
        "last_seen": "2026-11-22T21:05:02.471Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "smartbill-mcp",
      "version": "1.27.4",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 981,
      "sample": [
        {
          "id": "22186",
          "url": "https://mcp.easyscribe.guide/mcp",
          "server_name": "guide.easyscribe/easy-scribe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T17:59:02.319Z"
        },
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        }
      ]
    },
    "same_site": {
      "total": 1103,
      "sample": [
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        },
        {
          "id": "42106",
          "url": "https://adminpulse.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adminpulse",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:29:00.620Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.usefulapi",
      "total": 1103,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/m190/usefulapi-mcp",
      "total": 1103,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "42941",
    "server_name": "io.usefulapi/smartbill",
    "url": "https://smartbill.usefulapi.io/mcp",
    "host": "smartbill.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T21:05:02.471Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "e496fd4541670a29182415cdae729144d8f3fbed2d5bd0198bc53e33f85f58db",
    "first_listed_at": "2026-11-22T21:05:02.471Z",
    "created_at": "2026-11-21T12:45:10.584Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/smartbill",
    "title": "SmartBill MCP by usefulapi",
    "description": "Read SmartBill series, taxes, stock, clients and products; draft and issue invoices and estimates.",
    "version": "1.27.4",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/smartbill/",
    "published_at": "2026-11-18T11:02:23.115Z",
    "updated_at": "2026-11-18T11:02:23.115Z",
    "first_seen": "2026-11-21T12:45:09.941Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T21:05:14.729Z"
  },
  "operator": {
    "key": "usefulapi.io",
    "name": "usefulapi.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 314,
    "first_check_in_window": "2026-11-22T21:05:02.471Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "e496fd4541670a29182415cdae729144d8f3fbed2d5bd0198bc53e33f85f58db",
    "tools": 23,
    "resources": 0,
    "prompts": 7,
    "first_seen": "2026-11-22T21:05:02.790Z",
    "tool_names": [
      "smartbill_list_series",
      "smartbill_list_taxes",
      "smartbill_get_stock",
      "smartbill_get_invoice_payment_status",
      "smartbill_get_estimate_invoices",
      "smartbill_list_clients",
      "smartbill_get_client",
      "smartbill_list_suppliers",
      "smartbill_get_supplier",
      "smartbill_list_products",
      "smartbill_get_product",
      "smartbill_list_warehouses",
      "smartbill_list_vat_rates",
      "smartbill_create_invoice",
      "smartbill_create_invoice_from_estimate",
      "smartbill_create_estimate",
      "smartbill_reverse_invoice",
      "smartbill_cancel_invoice",
      "smartbill_restore_invoice",
      "smartbill_cancel_estimate",
      "smartbill_restore_estimate",
      "smartbill_record_invoice_payment",
      "smartbill_send_document"
    ],
    "declared": {
      "tools": [
        {
          "name": "smartbill_list_series",
          "title": "List document series",
          "description": "List the document series configured in SmartBill Cloud with their next number. Invoice and proforma tools need a series name from here. type: f = invoice series, p = proforma, c = receipt (chitanta); omit for all. GET /series.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "type": {
                "enum": [
                  "f",
                  "p",
                  "c"
                ],
                "type": "string",
                "description": "f = invoices, p = proformas, c = receipts; omit for all."
              }
            }
          },
          "annotations": {
            "title": "List document series",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_taxes",
          "title": "List VAT rates (V1)",
          "description": "List the VAT rates configured in the account (name and percentage). Use the name as tax_name and the percentage as tax_percentage on document lines. Works without a V3 token. GET /tax.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List VAT rates (V1)",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_stock",
          "title": "Get stock levels",
          "description": "Stock quantities per warehouse as of a date (needs the SmartBill stock module). Optional filters: warehouse_name (case-sensitive), product_name, product_code. No filters = all products in all warehouses. GET /stocks.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "date"
            ],
            "properties": {
              "date": {
                "type": "string",
                "description": "Date yyyy-mm-dd the stock is read at."
              },
              "product_code": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "product_name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1
              },
              "warehouse_name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Warehouse name, case-sensitive."
              }
            }
          },
          "annotations": {
            "title": "Get stock levels",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_invoice_payment_status",
          "title": "Get invoice payment status",
          "description": "Whether an invoice is paid and how much remains: invoiceTotalAmount, paidAmount, unpaidAmount and the paid flag. GET /invoice/paymentstatus.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Document number as text, e.g. \"0025\" (keep leading zeros)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              }
            }
          },
          "annotations": {
            "title": "Get invoice payment status",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_estimate_invoices",
          "title": "Get invoices of a proforma",
          "description": "Whether a proforma was invoiced and the invoices (series, number) made from it. A draft invoice shows with an empty number. GET /estimate/invoices.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Proforma number as text."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Proforma series name."
              }
            }
          },
          "annotations": {
            "title": "Get invoices of a proforma",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_clients",
          "title": "List or search clients",
          "description": "List clients from the SmartBill client list, optionally filtered by name (partial, case-insensitive), internal code (exact) or CIF (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/clients.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Exact internal client code (case-sensitive)."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Part of the client name."
              },
              "after": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: continue after this id (use next_args from the previous reply). Not together with before."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page, 1-100 (default 20)."
              },
              "before": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: go back before this id (use previous_args). Not together with after."
              },
              "vat_code": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Exact client CIF."
              }
            }
          },
          "annotations": {
            "title": "List or search clients",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_client",
          "title": "Get a client",
          "description": "One client by V3 id (cus_...): name, CIF, address, bank, contact, VAT-payer flag and delivery addresses. Needs the API V3 token. GET /v3/companies/{cif}/clients/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^cus_[A-Za-z0-9]{1,64}$",
                "description": "The client id (cus_...), from the list tool."
              }
            }
          },
          "annotations": {
            "title": "Get a client",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_suppliers",
          "title": "List or search suppliers",
          "description": "List suppliers, optionally filtered by name (partial), internal code (exact) or CIF (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/suppliers.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Exact internal supplier code (case-sensitive)."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Part of the supplier name."
              },
              "after": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: continue after this id (use next_args from the previous reply). Not together with before."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page, 1-100 (default 20)."
              },
              "before": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: go back before this id (use previous_args). Not together with after."
              },
              "vat_code": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Exact supplier CIF."
              }
            }
          },
          "annotations": {
            "title": "List or search suppliers",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_supplier",
          "title": "Get a supplier",
          "description": "One supplier by V3 id (sup_...). Needs the API V3 token. GET /v3/companies/{cif}/suppliers/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^sup_[A-Za-z0-9]{1,64}$",
                "description": "The supplier id (sup_...), from the list tool."
              }
            }
          },
          "annotations": {
            "title": "Get a supplier",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_products",
          "title": "List or search products and services",
          "description": "List the product and service catalog (price, unit, VAT rate, currency), optionally filtered by name (whole-word match) or internal code (exact). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/products.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Exact product code (case-sensitive)."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "A word of the product name."
              },
              "after": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: continue after this id (use next_args from the previous reply). Not together with before."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page, 1-100 (default 20)."
              },
              "before": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: go back before this id (use previous_args). Not together with after."
              }
            }
          },
          "annotations": {
            "title": "List or search products and services",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_get_product",
          "title": "Get a product or service",
          "description": "One product or service by V3 id (prod_...). Needs the API V3 token. GET /v3/companies/{cif}/products/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^prod_[A-Za-z0-9]{1,64}$",
                "description": "The product id (prod_...), from the list tool."
              }
            }
          },
          "annotations": {
            "title": "Get a product or service",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_warehouses",
          "title": "List warehouses",
          "description": "List warehouses (name, type en gros / en detail, keeper, address). Needs the API V3 token. Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/warehouses.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Part of the warehouse name."
              },
              "after": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: continue after this id (use next_args from the previous reply). Not together with before."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page, 1-100 (default 20)."
              },
              "before": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: go back before this id (use previous_args). Not together with after."
              }
            }
          },
          "annotations": {
            "title": "List warehouses",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_list_vat_rates",
          "title": "List VAT rates (V3)",
          "description": "List VAT rates with ids, name, percentage and reverse-charge flag. Filter by name (partial) or percentage (exact). Needs the API V3 token (smartbill_list_taxes does the same without it). Cursor paged: pass the reply's next_args as the next call's arguments. GET /v3/companies/{cif}/vat-rates.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Part of the VAT rate name."
              },
              "after": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: continue after this id (use next_args from the previous reply). Not together with before."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page, 1-100 (default 20)."
              },
              "before": {
                "type": "string",
                "pattern": "^[a-z]{2,5}_[A-Za-z0-9]{1,64}$",
                "description": "Cursor: go back before this id (use previous_args). Not together with after."
              },
              "percentage": {
                "type": "number",
                "maximum": 100,
                "minimum": 0,
                "description": "Exact percentage."
              }
            }
          },
          "annotations": {
            "title": "List VAT rates (V3)",
            "readOnlyHint": true
          }
        },
        {
          "name": "smartbill_create_invoice",
          "title": "Create an invoice",
          "description": "Create an invoice for a client with product/service lines. By default it is saved as a DRAFT (no number) for review in SmartBill Cloud. With draft=false the invoice is ISSUED: it takes the next number of the series, cannot be deleted or edited through this server, can only be cancelled or reversed (storno), and, depending on the account's e-Factura setup, may be transmitted to ANAF. Confirm every field with the user before draft=false. Returns series, number, documentId, documentUrl (needs login) and documentViewUrl (public PDF link). POST /invoice/v2.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "client",
              "products"
            ],
            "properties": {
              "draft": {
                "type": "boolean",
                "description": "Default TRUE: the document is saved as a draft without a number, to be finalized in SmartBill Cloud. Pass false ONLY when the user explicitly wants it ISSUED now: that takes the next number of the series, cannot be undone from the API, and may be transmitted to e-Factura / ANAF depending on the account setup."
              },
              "client": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "bank": {
                    "type": "string",
                    "maxLength": 100
                  },
                  "city": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "City. When county is Bucuresti this must be Sector 1 - Sector 6, or e-Factura will not validate in SPV."
                  },
                  "iban": {
                    "type": "string",
                    "maxLength": 50
                  },
                  "name": {
                    "type": "string",
                    "maxLength": 255,
                    "minLength": 1,
                    "description": "Client name (company or person)."
                  },
                  "email": {
                    "type": "string",
                    "maxLength": 254
                  },
                  "phone": {
                    "type": "string",
                    "maxLength": 50
                  },
                  "county": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "County (or region/state for foreign clients)."
                  },
                  "address": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "contact": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "Contact person."
                  },
                  "country": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1,
                    "description": "Country name or usual code (default Romania)."
                  },
                  "reg_com": {
                    "type": "string",
                    "maxLength": 50,
                    "description": "Trade register number."
                  },
                  "vat_code": {
                    "type": "string",
                    "maxLength": 30,
                    "description": "Client CUI/CIF or foreign VAT code."
                  },
                  "save_to_db": {
                    "type": "boolean",
                    "description": "Also save the client in the SmartBill client list when new (default false)."
                  },
                  "is_tax_payer": {
                    "type": "boolean",
                    "description": "Client is a VAT payer (default false: stored as non-payer)."
                  }
                },
                "description": "The client the document is issued to."
              },
              "currency": {
                "enum": [
                  "RON",
                  "EUR",
                  "USD",
                  "GBP",
                  "CAD",
                  "AUD",
                  "CHF",
                  "TRY",
                  "CZK",
                  "DKK",
                  "HUF",
                  "MDL",
                  "SEK",
                  "NOK",
                  "JPY",
                  "EGP",
                  "PLN",
                  "RUB",
                  "AED",
                  "BRL",
                  "CNY",
                  "HRK",
                  "INR",
                  "KRW",
                  "MXN",
                  "NZD",
                  "RSD",
                  "THB",
                  "UAH",
                  "XDR",
                  "ZAR"
                ],
                "type": "string",
                "description": "Document currency (default RON)."
              },
              "due_date": {
                "type": "string",
                "description": "Due date yyyy-mm-dd."
              },
              "language": {
                "enum": [
                  "RO",
                  "EN",
                  "DE",
                  "FR",
                  "IT",
                  "ES"
                ],
                "type": "string",
                "description": "Document language (default RO)."
              },
              "mentions": {
                "type": "string",
                "maxLength": 2000,
                "description": "Mentions shown on the document."
              },
              "products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "quantity",
                    "unit",
                    "price",
                    "tax_percentage"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "maxLength": 100,
                      "description": "Product code (SKU); required when the account has \"use product code\" enabled."
                    },
                    "name": {
                      "type": "string",
                      "maxLength": 255,
                      "minLength": 1,
                      "description": "Product or service name."
                    },
                    "unit": {
                      "type": "string",
                      "maxLength": 50,
                      "minLength": 1,
                      "description": "Unit of measure as configured in SmartBill, e.g. buc, ora, kg."
                    },
                    "price": {
                      "type": "number",
                      "maximum": 1000000000000,
                      "minimum": 0,
                      "description": "Unit price: WITHOUT VAT unless is_tax_included is true."
                    },
                    "quantity": {
                      "type": "number",
                      "maximum": 1000000000,
                      "description": "Quantity, greater than 0 (the API itself accepts 0 and negatives; this server does not).",
                      "exclusiveMinimum": 0
                    },
                    "tax_name": {
                      "type": "string",
                      "maxLength": 100,
                      "description": "VAT rate name as in the account (smartbill_list_taxes), e.g. Normala."
                    },
                    "is_service": {
                      "type": "boolean",
                      "description": "True for a service."
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 1000,
                      "description": "Extra description."
                    },
                    "tax_percentage": {
                      "type": "number",
                      "maximum": 100,
                      "minimum": 0,
                      "description": "VAT percentage of the line, e.g. 21, 11, 0."
                    },
                    "is_tax_included": {
                      "type": "boolean",
                      "description": "The price already includes VAT (default false)."
                    }
                  }
                },
                "maxItems": 200,
                "minItems": 1,
                "description": "1-200 lines."
              },
              "issue_date": {
                "type": "string",
                "description": "Issue date yyyy-mm-dd (default today)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              },
              "observations": {
                "type": "string",
                "maxLength": 2000,
                "description": "Observations shown on the document."
              },
              "exchange_rate": {
                "type": "number",
                "maximum": 1000000,
                "description": "Exchange rate to RON (default: SmartBill's rate for the date).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Create an invoice",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_create_invoice_from_estimate",
          "title": "Create an invoice from a proforma",
          "description": "Create an invoice from an existing proforma (client and lines are copied from it). Default is a DRAFT; with draft=false the invoice is ISSUED with the next number of the series and may be transmitted to e-Factura / ANAF. Stock is not discharged. POST /invoice/v2 (useEstimateDetails).",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "estimate_series",
              "estimate_number"
            ],
            "properties": {
              "draft": {
                "type": "boolean",
                "description": "Default TRUE: the document is saved as a draft without a number, to be finalized in SmartBill Cloud. Pass false ONLY when the user explicitly wants it ISSUED now: that takes the next number of the series, cannot be undone from the API, and may be transmitted to e-Factura / ANAF depending on the account setup."
              },
              "issue_date": {
                "type": "string",
                "description": "Issue date yyyy-mm-dd (default today)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Invoice series to issue on."
              },
              "estimate_number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Number of the source proforma as text."
              },
              "estimate_series": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Series of the source proforma."
              }
            }
          },
          "annotations": {
            "title": "Create an invoice from a proforma",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_create_estimate",
          "title": "Create a proforma",
          "description": "Create a proforma (estimate) for a client with product/service lines. Default is a DRAFT (no number); with draft=false it takes the next number of the proforma series. A proforma is not a fiscal invoice. Returns series, number, documentId and links. POST /estimate/v2.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "client",
              "products"
            ],
            "properties": {
              "draft": {
                "type": "boolean",
                "description": "Default TRUE: the document is saved as a draft without a number, to be finalized in SmartBill Cloud. Pass false ONLY when the user explicitly wants it ISSUED now: that takes the next number of the series, cannot be undone from the API, and may be transmitted to e-Factura / ANAF depending on the account setup."
              },
              "client": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "bank": {
                    "type": "string",
                    "maxLength": 100
                  },
                  "city": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "City. When county is Bucuresti this must be Sector 1 - Sector 6, or e-Factura will not validate in SPV."
                  },
                  "iban": {
                    "type": "string",
                    "maxLength": 50
                  },
                  "name": {
                    "type": "string",
                    "maxLength": 255,
                    "minLength": 1,
                    "description": "Client name (company or person)."
                  },
                  "email": {
                    "type": "string",
                    "maxLength": 254
                  },
                  "phone": {
                    "type": "string",
                    "maxLength": 50
                  },
                  "county": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "County (or region/state for foreign clients)."
                  },
                  "address": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "contact": {
                    "type": "string",
                    "maxLength": 100,
                    "description": "Contact person."
                  },
                  "country": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1,
                    "description": "Country name or usual code (default Romania)."
                  },
                  "reg_com": {
                    "type": "string",
                    "maxLength": 50,
                    "description": "Trade register number."
                  },
                  "vat_code": {
                    "type": "string",
                    "maxLength": 30,
                    "description": "Client CUI/CIF or foreign VAT code."
                  },
                  "save_to_db": {
                    "type": "boolean",
                    "description": "Also save the client in the SmartBill client list when new (default false)."
                  },
                  "is_tax_payer": {
                    "type": "boolean",
                    "description": "Client is a VAT payer (default false: stored as non-payer)."
                  }
                },
                "description": "The client the document is issued to."
              },
              "currency": {
                "enum": [
                  "RON",
                  "EUR",
                  "USD",
                  "GBP",
                  "CAD",
                  "AUD",
                  "CHF",
                  "TRY",
                  "CZK",
                  "DKK",
                  "HUF",
                  "MDL",
                  "SEK",
                  "NOK",
                  "JPY",
                  "EGP",
                  "PLN",
                  "RUB",
                  "AED",
                  "BRL",
                  "CNY",
                  "HRK",
                  "INR",
                  "KRW",
                  "MXN",
                  "NZD",
                  "RSD",
                  "THB",
                  "UAH",
                  "XDR",
                  "ZAR"
                ],
                "type": "string",
                "description": "Document currency (default RON)."
              },
              "due_date": {
                "type": "string",
                "description": "Due date yyyy-mm-dd."
              },
              "language": {
                "enum": [
                  "RO",
                  "EN",
                  "DE",
                  "FR",
                  "IT",
                  "ES"
                ],
                "type": "string",
                "description": "Document language (default RO)."
              },
              "mentions": {
                "type": "string",
                "maxLength": 2000,
                "description": "Mentions shown on the document."
              },
              "products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "quantity",
                    "unit",
                    "price",
                    "tax_percentage"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "maxLength": 100,
                      "description": "Product code (SKU); required when the account has \"use product code\" enabled."
                    },
                    "name": {
                      "type": "string",
                      "maxLength": 255,
                      "minLength": 1,
                      "description": "Product or service name."
                    },
                    "unit": {
                      "type": "string",
                      "maxLength": 50,
                      "minLength": 1,
                      "description": "Unit of measure as configured in SmartBill, e.g. buc, ora, kg."
                    },
                    "price": {
                      "type": "number",
                      "maximum": 1000000000000,
                      "minimum": 0,
                      "description": "Unit price: WITHOUT VAT unless is_tax_included is true."
                    },
                    "quantity": {
                      "type": "number",
                      "maximum": 1000000000,
                      "description": "Quantity, greater than 0 (the API itself accepts 0 and negatives; this server does not).",
                      "exclusiveMinimum": 0
                    },
                    "tax_name": {
                      "type": "string",
                      "maxLength": 100,
                      "description": "VAT rate name as in the account (smartbill_list_taxes), e.g. Normala."
                    },
                    "is_service": {
                      "type": "boolean",
                      "description": "True for a service."
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 1000,
                      "description": "Extra description."
                    },
                    "tax_percentage": {
                      "type": "number",
                      "maximum": 100,
                      "minimum": 0,
                      "description": "VAT percentage of the line, e.g. 21, 11, 0."
                    },
                    "is_tax_included": {
                      "type": "boolean",
                      "description": "The price already includes VAT (default false)."
                    }
                  }
                },
                "maxItems": 200,
                "minItems": 1,
                "description": "1-200 lines."
              },
              "issue_date": {
                "type": "string",
                "description": "Issue date yyyy-mm-dd (default today)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              },
              "observations": {
                "type": "string",
                "maxLength": 2000,
                "description": "Observations shown on the document."
              },
              "exchange_rate": {
                "type": "number",
                "maximum": 1000000,
                "description": "Exchange rate to RON (default: SmartBill's rate for the date).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Create a proforma",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_reverse_invoice",
          "title": "Reverse an invoice (storno)",
          "description": "ISSUE a storno (credit) invoice that reverses an issued invoice. It takes the next number, an invoice can be reversed only once, and the storno cannot be undone; it may be transmitted to e-Factura / ANAF. Confirm the exact series and number with the user first. POST /invoice/reverse.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Number of the invoice to reverse, as text."
              },
              "issue_date": {
                "type": "string",
                "description": "Date of the storno invoice yyyy-mm-dd (default today; not before the original's date)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Series of the invoice to reverse."
              }
            }
          },
          "annotations": {
            "title": "Reverse an invoice (storno)",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_cancel_invoice",
          "title": "Cancel an invoice",
          "description": "Cancel an existing invoice (it stays in the books as cancelled; smartbill_restore_invoice undoes it). Changes the document's fiscal status, so confirm with the user. PUT /invoice/cancel.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Document number as text, e.g. \"0025\" (keep leading zeros)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              }
            }
          },
          "annotations": {
            "title": "Cancel an invoice",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_restore_invoice",
          "title": "Restore a cancelled invoice",
          "description": "Restore an invoice that was cancelled, making it active again. PUT /invoice/restore.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Document number as text, e.g. \"0025\" (keep leading zeros)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              }
            }
          },
          "annotations": {
            "title": "Restore a cancelled invoice",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_cancel_estimate",
          "title": "Cancel a proforma",
          "description": "Cancel an existing proforma (smartbill_restore_estimate undoes it). PUT /estimate/cancel.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Proforma number as text."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Proforma series name."
              }
            }
          },
          "annotations": {
            "title": "Cancel a proforma",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_restore_estimate",
          "title": "Restore a cancelled proforma",
          "description": "Restore a proforma that was cancelled. PUT /estimate/restore.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "series_name",
              "number"
            ],
            "properties": {
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Proforma number as text."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Proforma series name."
              }
            }
          },
          "annotations": {
            "title": "Restore a cancelled proforma",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_record_invoice_payment",
          "title": "Record a payment against invoices",
          "description": "Record a collection (incasare) against one or more issued invoices; client and amount are taken from the invoices. With value (single invoice only) a partial payment is recorded. type Chitanta issues a numbered RECEIPT on receipt_series (cannot be undone from this server); the other types (Card, Ordin plata, ...) record the payment without a document. It changes the invoice's paid status in the books: confirm with the user. Fiscal receipts (Bon) are not supported. POST /payment.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "invoices",
              "type"
            ],
            "properties": {
              "text": {
                "type": "string",
                "maxLength": 500,
                "description": "Description of the payment."
              },
              "type": {
                "enum": [
                  "Chitanta",
                  "Card",
                  "Card online",
                  "CEC",
                  "Bilet ordin",
                  "Ordin plata",
                  "Mandat postal",
                  "Extras de cont",
                  "Ramburs",
                  "Alta incasare"
                ],
                "type": "string",
                "description": "Payment type. Chitanta = a numbered receipt (needs receipt_series); the others create no document."
              },
              "value": {
                "type": "number",
                "maximum": 1000000000000,
                "description": "Partial amount, for a single invoice only; omit to collect the invoice's full amount.",
                "exclusiveMinimum": 0
              },
              "is_cash": {
                "type": "boolean",
                "description": "Mark the collection as cash (typically for Chitanta)."
              },
              "invoices": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "series_name",
                    "number"
                  ],
                  "properties": {
                    "number": {
                      "type": "string",
                      "maxLength": 30,
                      "minLength": 1,
                      "description": "Document number as text, e.g. \"0025\" (keep leading zeros)."
                    },
                    "series_name": {
                      "type": "string",
                      "maxLength": 50,
                      "minLength": 1,
                      "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
                    }
                  }
                },
                "maxItems": 20,
                "minItems": 1,
                "description": "1-20 invoices the payment is for."
              },
              "issue_date": {
                "type": "string",
                "description": "Payment date yyyy-mm-dd (default today)."
              },
              "receipt_series": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Receipt series; required for type Chitanta (smartbill_list_series with type c)."
              }
            }
          },
          "annotations": {
            "title": "Record a payment against invoices",
            "destructiveHint": true
          }
        },
        {
          "name": "smartbill_send_document",
          "title": "Email an invoice or proforma",
          "description": "Send an issued invoice or proforma by email from SmartBill. This EMAILS A THIRD PARTY and cannot be recalled. Without `to` it goes to the client's email on the document; without subject/body_text the account's email template is used. Confirm the recipient with the user first. POST /document/send.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "type",
              "series_name",
              "number"
            ],
            "properties": {
              "cc": {
                "type": "string",
                "maxLength": 500,
                "description": "CC addresses, comma separated."
              },
              "to": {
                "type": "string",
                "pattern": "^[^\\s@,;<>\"]+@[^\\s@,;<>\"]+\\.[^\\s@,;<>\"]+$",
                "maxLength": 254,
                "description": "Recipient (default: the client's email on the document)."
              },
              "bcc": {
                "type": "string",
                "maxLength": 500,
                "description": "BCC addresses, comma separated."
              },
              "type": {
                "enum": [
                  "factura",
                  "proforma"
                ],
                "type": "string",
                "description": "factura = invoice, proforma = proforma."
              },
              "number": {
                "type": "string",
                "maxLength": 30,
                "minLength": 1,
                "description": "Document number as text, e.g. \"0025\" (keep leading zeros)."
              },
              "subject": {
                "type": "string",
                "maxLength": 300,
                "minLength": 1,
                "description": "Email subject, plain text (default: the account template)."
              },
              "body_text": {
                "type": "string",
                "maxLength": 5000,
                "minLength": 1,
                "description": "Email body, plain text (default: the account template)."
              },
              "series_name": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Document series name exactly as configured in SmartBill Cloud (smartbill_list_series lists them)."
              }
            }
          },
          "annotations": {
            "title": "Email an invoice or proforma",
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with SmartBill here, with example requests to try."
        },
        {
          "name": "check_invoice_payments_and_proforma_invoicing_status",
          "description": "The AI reads the total, paid amount, unpaid amount and paid flag of an invoice. It can also show whether a proforma was invoiced and which invoices came from it."
        },
        {
          "name": "check_stock_levels_per_warehouse",
          "description": "The AI reads stock quantities per warehouse as of a date, filtered by warehouse, product name or code, and lists the warehouses. It needs the SmartBill stock module."
        },
        {
          "name": "look_up_clients_suppliers_and_products",
          "description": "The AI searches clients and suppliers by name, internal code or CIF, and lists products and services with price, unit and VAT rate. It then opens one record for details."
        },
        {
          "name": "check_document_series_and_vat_rates",
          "description": "The AI lists the document series with their next number, and the VAT rates configured in the account. You need these before you make a document."
        },
        {
          "name": "draft_an_invoice_or_proforma_for_a_client",
          "description": "The AI creates an invoice or proforma with product or service lines, or an invoice from a proforma. By default it saves a draft with no number for review in SmartBill Cloud."
        },
        {
          "name": "record_a_payment_email_cancel_or_reverse_an_invoice",
          "description": "The AI records a payment against issued invoices, emails an invoice or proforma, cancels an invoice, or issues a storno to reverse one. Emails and storno cannot be undone."
        }
      ]
    },
    "instructions": "Tools for SmartBill, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Has invoice FCT 0042 been paid, and how much is still owed?\"; \"Which VAT rates are set up in my billing account?\"; \"How much stock do we have in each warehouse today?\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes SmartBill data. Free plan: 50 tool calls per month. Run smartbill_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run smartbill_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run smartbill_upgrade without a plan: it returns both plans, each with a payment link for the user to open. smartbill_cancel_subscription cancels Pro at the end of the paid period."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}