{
  "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": "billy.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "172.67.138.37",
        "endpoints": 820,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.62.184",
        "endpoints": 820,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 820,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 820,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.138.37",
          "104.21.62.184",
          "2606:4700:3030::ac43:8a25",
          "2606:4700:3032::6815:3eb8"
        ],
        "first_seen": "2026-11-21T19:43:00.751Z",
        "last_seen": "2026-11-21T19:43:00.751Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "billy-mcp",
      "version": "1.27.4",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 819,
      "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": 1097,
      "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": 1097,
      "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": 1097,
      "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": "42180",
    "server_name": "io.usefulapi/billy",
    "url": "https://billy.usefulapi.io/mcp",
    "host": "billy.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T19:43:00.751Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "1fb72e26c23ec916eaa6bcbdc9e8d0a12e70af4a4923715095580f0688e83d6a",
    "first_listed_at": "2026-11-21T19:43:00.751Z",
    "created_at": "2026-11-21T12:35:10.930Z",
    "resolved_addresses": [
      "172.67.138.37",
      "104.21.62.184",
      "2606:4700:3030::ac43:8a25",
      "2606:4700:3032::6815:3eb8"
    ]
  },
  "server": {
    "name": "io.usefulapi/billy",
    "title": "Billy MCP by usefulapi",
    "description": "Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.",
    "version": "1.27.4",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/billy/",
    "published_at": "2026-11-18T11:02:20.502Z",
    "updated_at": "2026-11-18T11:02:20.502Z",
    "first_seen": "2026-11-21T12:35:10.310Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:46:08.234Z"
  },
  "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": 262,
    "first_check_in_window": "2026-11-21T19:43:00.751Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "1fb72e26c23ec916eaa6bcbdc9e8d0a12e70af4a4923715095580f0688e83d6a",
    "tools": 15,
    "resources": 0,
    "prompts": 6,
    "first_seen": "2026-11-21T19:43:01.133Z",
    "tool_names": [
      "billy_get_organization",
      "billy_list_contacts",
      "billy_get_contact",
      "billy_list_invoices",
      "billy_get_invoice",
      "billy_list_bills",
      "billy_get_bill",
      "billy_list_products",
      "billy_get_product",
      "billy_list_accounts",
      "billy_list_tax_rates",
      "billy_list_bank_lines",
      "billy_list_postings",
      "billy_create_contact",
      "billy_create_draft_invoice"
    ],
    "declared": {
      "tools": [
        {
          "name": "billy_get_organization",
          "title": "Get the company",
          "description": "The Billy company the access token belongs to: id, name, address, registration (CVR) number, base currency, VAT settings, fiscal year, default payment terms, invoice numbering, default accounts. Good first call. GET /organization.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "Get the company",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_contacts",
          "title": "List contacts",
          "description": "List customers and suppliers: name, type, address, CVR/registration number, EAN, payment terms, customer/supplier flags. The API has no documented search filter, so `search` is applied to the returned page only (case-insensitive on name, contact number and registration number); page on with next_page to look further. Paged. GET /contacts.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "search": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Keep only contacts on the returned page whose name, contactNo or registrationNo contains this text."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              }
            }
          },
          "annotations": {
            "title": "List contacts",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_get_contact",
          "title": "Get a contact",
          "description": "One contact by id, with its contact persons (names and e-mail addresses). GET /contacts/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The contact id (from billy_list_contacts)."
              }
            }
          },
          "annotations": {
            "title": "Get a contact",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_invoices",
          "title": "List invoices",
          "description": "List sales invoices and credit notes (newest first by default): number, date, due date, state (draft/approved/voided), amount, tax, balance, isPaid, contactId, currency. Filter by state, customer, number, date, period, paid status or free text. Paged. GET /invoices.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Free-text search over invoice number, order number, contact name, line description, amount."
              },
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "state": {
                "enum": [
                  "draft",
                  "approved",
                  "voided"
                ],
                "type": "string",
                "description": "Only invoices in this state."
              },
              "is_paid": {
                "type": "boolean",
                "description": "true = only paid invoices, false = only unpaid."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              },
              "contact_id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "Only invoices of this contact (from billy_list_contacts)."
              },
              "invoice_no": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1,
                "description": "Exact invoice number."
              },
              "max_due_date": {
                "type": "string",
                "description": "Due date on or before (yyyy-mm-dd); with is_paid=false this finds overdue invoices."
              },
              "min_due_date": {
                "type": "string",
                "description": "Due date on or after (yyyy-mm-dd)."
              },
              "sort_property": {
                "enum": [
                  "entryDate",
                  "dueDate",
                  "createdTime",
                  "invoiceNo",
                  "amount",
                  "balance",
                  "contact.name",
                  "approvedTime"
                ],
                "type": "string",
                "description": "Sort by (default entryDate)."
              },
              "max_entry_date": {
                "type": "string",
                "description": "Invoice date on or before (yyyy-mm-dd)."
              },
              "min_entry_date": {
                "type": "string",
                "description": "Invoice date on or after (yyyy-mm-dd)."
              },
              "sort_direction": {
                "enum": [
                  "ASC",
                  "DESC"
                ],
                "type": "string",
                "description": "Sort direction (default ASC)."
              },
              "entry_date_period": {
                "type": "string",
                "pattern": "^[A-Za-z0-9:.,-]{1,80}$",
                "description": "Date period: all, year:2026, month:2026-03, quarter:2026-2, dates:2026-01-01...2026-01-31 ..."
              }
            }
          },
          "annotations": {
            "title": "List invoices",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_get_invoice",
          "title": "Get an invoice",
          "description": "One invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations. GET /invoices/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The invoice id (from billy_list_invoices)."
              }
            }
          },
          "annotations": {
            "title": "Get an invoice",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_bills",
          "title": "List bills (supplier invoices)",
          "description": "List bills (purchase invoices from suppliers): supplier, dates, state (draft/approved/voided), amount, balance, isPaid, supplier invoice number. Filter by state, supplier, dates or paid status. Paged. GET /bills.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Free-text search over supplier name, description, voucher number, amount, supplier invoice number."
              },
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "state": {
                "enum": [
                  "draft",
                  "approved",
                  "voided"
                ],
                "type": "string",
                "description": "Only bills in this state."
              },
              "is_paid": {
                "type": "boolean",
                "description": "true = only paid bills, false = only unpaid."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              },
              "contact_id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "Only bills of this supplier contact."
              },
              "max_due_date": {
                "type": "string",
                "description": "Due date on or before (yyyy-mm-dd)."
              },
              "min_due_date": {
                "type": "string",
                "description": "Due date on or after (yyyy-mm-dd)."
              },
              "sort_property": {
                "enum": [
                  "entryDate",
                  "dueDate",
                  "createdTime",
                  "amount",
                  "balance",
                  "contact.name",
                  "voucherNo",
                  "suppliersInvoiceNo"
                ],
                "type": "string",
                "description": "Sort by (default entryDate)."
              },
              "max_entry_date": {
                "type": "string",
                "description": "Bill date on or before (yyyy-mm-dd)."
              },
              "min_entry_date": {
                "type": "string",
                "description": "Bill date on or after (yyyy-mm-dd)."
              },
              "sort_direction": {
                "enum": [
                  "ASC",
                  "DESC"
                ],
                "type": "string",
                "description": "Sort direction (default ASC)."
              },
              "suppliers_invoice_no": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Exact supplier invoice number."
              }
            }
          },
          "annotations": {
            "title": "List bills (supplier invoices)",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_get_bill",
          "title": "Get a bill",
          "description": "One supplier bill by id with its lines. GET /bills/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The bill id (from billy_list_bills)."
              }
            }
          },
          "annotations": {
            "title": "Get a bill",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_products",
          "title": "List products",
          "description": "List products and services usable as invoice lines: name, product number, description, sales account, archived flag. The API has no documented search filter, so `search` is applied to the returned page only (name, productNo). Paged. GET /products.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "search": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Keep only products on the returned page whose name or productNo contains this text."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              }
            }
          },
          "annotations": {
            "title": "List products",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_get_product",
          "title": "Get a product",
          "description": "One product by id with its unit prices per currency. GET /products/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The product id (from billy_list_products)."
              }
            }
          },
          "annotations": {
            "title": "Get a product",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_accounts",
          "title": "List accounts (chart of accounts)",
          "description": "The chart of accounts: account number, name, group, nature, VAT rate, bank-account flag and bank details (IBAN, bank name) of bank accounts. With is_bank_account=true this lists the bank accounts whose ids billy_list_bank_lines needs. Paged. GET /accounts.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              },
              "is_bank_account": {
                "type": "boolean",
                "description": "true = only bank accounts."
              }
            }
          },
          "annotations": {
            "title": "List accounts (chart of accounts)",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_tax_rates",
          "title": "List tax (VAT) rates",
          "description": "The company's VAT rates: name, rate (as a fraction, 0.25 = 25 percent), whether it applies to sales or purchases, active flag. Paged. GET /taxRates.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              }
            }
          },
          "annotations": {
            "title": "List tax (VAT) rates",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_bank_lines",
          "title": "List bank lines",
          "description": "List the bank-statement lines of ONE bank account (read only; nothing is matched or reconciled): date, description, amount, side (debit/credit), reconciled flag, receipt state. Get the account id from billy_list_accounts with is_bank_account=true. Paged. GET /bankLines.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "account_id"
            ],
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Free-text search over description or amount."
              },
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "side": {
                "enum": [
                  "debit",
                  "credit"
                ],
                "type": "string",
                "description": "Only debit (money in) or credit (money out) lines."
              },
              "status": {
                "enum": [
                  "pending",
                  "booked"
                ],
                "type": "string",
                "description": "Line status (the API defaults to booked)."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              },
              "account_id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The bank account id (required)."
              },
              "max_amount": {
                "type": "number",
                "maximum": 1000000000000,
                "minimum": 0,
                "description": "Amount at most."
              },
              "min_amount": {
                "type": "number",
                "maximum": 1000000000000,
                "minimum": 0,
                "description": "Amount at least."
              },
              "is_reconciled": {
                "type": "boolean",
                "description": "true = only reconciled lines, false = only unreconciled."
              },
              "receipt_state": {
                "enum": [
                  "missing_receipt",
                  "receipt_uploaded"
                ],
                "type": "string",
                "description": "Only lines with a missing or uploaded receipt."
              },
              "sort_property": {
                "enum": [
                  "entryDate",
                  "amount"
                ],
                "type": "string",
                "description": "Sort by (default entryDate)."
              },
              "max_entry_date": {
                "type": "string",
                "description": "Entry date on or before (yyyy-mm-dd)."
              },
              "min_entry_date": {
                "type": "string",
                "description": "Entry date on or after (yyyy-mm-dd)."
              },
              "sort_direction": {
                "enum": [
                  "ASC",
                  "DESC"
                ],
                "type": "string",
                "description": "Sort direction (default ASC)."
              },
              "entry_date_period": {
                "type": "string",
                "pattern": "^[A-Za-z0-9:.,-]{1,80}$",
                "description": "Date period: all, year:2026, month:2026-03, quarter:2026-2, dates:2026-01-01...2026-01-31 ..."
              }
            }
          },
          "annotations": {
            "title": "List bank lines",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_list_postings",
          "title": "List ledger postings",
          "description": "List ledger postings (the bookkeeping entries): date, text, account, amount, side (debit/credit), currency, voided flag. Filter by account, date or period. Read only. Paged. GET /postings.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Free-text search over the posting text and the originator name."
              },
              "page": {
                "type": "integer",
                "maximum": 100000,
                "minimum": 1,
                "description": "Page number, 1-based (default 1). Use next_page from the previous reply."
              },
              "is_voided": {
                "type": "boolean",
                "description": "true = only voided postings, false = only live ones."
              },
              "page_size": {
                "type": "integer",
                "maximum": 200,
                "minimum": 1,
                "description": "Records per page, 1-200 (default 50)."
              },
              "account_id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "Only postings on this account (from billy_list_accounts)."
              },
              "max_entry_date": {
                "type": "string",
                "description": "Entry date on or before (yyyy-mm-dd)."
              },
              "min_entry_date": {
                "type": "string",
                "description": "Entry date on or after (yyyy-mm-dd)."
              },
              "entry_date_period": {
                "type": "string",
                "pattern": "^[A-Za-z0-9:.,-]{1,80}$",
                "description": "Date period: all, year:2026, month:2026-03, quarter:2026-2, dates:2026-01-01...2026-01-31 ..."
              }
            }
          },
          "annotations": {
            "title": "List ledger postings",
            "readOnlyHint": true
          }
        },
        {
          "name": "billy_create_contact",
          "title": "Create a contact",
          "description": "WRITE: create ONE new contact (customer and/or supplier) in the company's Billy account. It does not check for duplicates (call billy_list_contacts first) and nothing is sent to the contact. Not idempotent: a repeat call creates a second contact. POST /contacts.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name"
            ],
            "properties": {
              "ean": {
                "type": "string",
                "maxLength": 20,
                "description": "EAN location number for e-invoicing (Denmark)."
              },
              "city": {
                "type": "string",
                "maxLength": 255,
                "description": "City."
              },
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Company or person name."
              },
              "type": {
                "enum": [
                  "company",
                  "person"
                ],
                "type": "string",
                "description": "company (default) or person."
              },
              "email": {
                "type": "string",
                "format": "email",
                "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
                "maxLength": 255,
                "description": "Primary contact e-mail (stored as the primary contact person; nothing is sent)."
              },
              "phone": {
                "type": "string",
                "maxLength": 50,
                "description": "Phone number."
              },
              "street": {
                "type": "string",
                "maxLength": 255,
                "description": "Street and number."
              },
              "zipcode": {
                "type": "string",
                "maxLength": 20,
                "description": "Postal code."
              },
              "contact_no": {
                "type": "string",
                "maxLength": 50,
                "description": "Your own customer or supplier number."
              },
              "country_id": {
                "type": "string",
                "pattern": "^[A-Z]{2}$",
                "description": "ISO country code (default DK)."
              },
              "is_customer": {
                "type": "boolean",
                "description": "Customer flag (default true)."
              },
              "is_supplier": {
                "type": "boolean",
                "description": "Supplier flag (default false)."
              },
              "registration_no": {
                "type": "string",
                "maxLength": 50,
                "description": "CVR number (Denmark) or EU VAT number."
              }
            }
          },
          "annotations": {
            "title": "Create a contact",
            "destructiveHint": true
          }
        },
        {
          "name": "billy_create_draft_invoice",
          "title": "Create a draft invoice",
          "description": "WRITE: create ONE invoice in the DRAFT state for an existing contact. The invoice is NOT approved, booked, numbered into the ledger or sent: the user reviews it in Billy and approves and sends it there. The invoice number is assigned by Billy. No payment is created. Not idempotent: a repeat call creates a second draft. POST /invoices with state=draft.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "contact_id",
              "lines"
            ],
            "properties": {
              "lines": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "unit_price"
                  ],
                  "properties": {
                    "quantity": {
                      "type": "number",
                      "maximum": 1000000000,
                      "description": "Quantity (default 1).",
                      "exclusiveMinimum": 0
                    },
                    "product_id": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,64}$",
                      "description": "The product id (from billy_list_products)."
                    },
                    "unit_price": {
                      "type": "number",
                      "maximum": 1000000000,
                      "minimum": -1000000000,
                      "description": "Price per unit in the invoice currency (VAT excluded unless tax_mode is incl)."
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 2000,
                      "description": "Text shown under the product name on the invoice."
                    }
                  }
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "1-100 invoice lines."
              },
              "tax_mode": {
                "enum": [
                  "incl",
                  "excl"
                ],
                "type": "string",
                "description": "Whether unit prices include (incl) or exclude (excl) VAT (default: the company's setting)."
              },
              "contact_id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The customer's contact id (from billy_list_contacts or billy_create_contact)."
              },
              "entry_date": {
                "type": "string",
                "description": "Invoice date yyyy-mm-dd (default today, UTC)."
              },
              "currency_id": {
                "type": "string",
                "pattern": "^[A-Z]{3}$",
                "description": "Invoice currency, e.g. DKK (default: the company's base currency)."
              },
              "contact_message": {
                "type": "string",
                "maxLength": 2000,
                "description": "Message to the customer shown at the top of the invoice PDF."
              }
            }
          },
          "annotations": {
            "title": "Create a draft invoice",
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with Billy here, with example requests to try."
        },
        {
          "name": "find_unpaid_invoices_past_their_due_date",
          "description": "The AI lists sales invoices by state and paid status with due date, amount and balance, and shows which customers owe money."
        },
        {
          "name": "total_what_you_invoiced_in_a_period",
          "description": "The AI lists sales invoices and credit notes for a date range or period, and sums the amount and tax."
        },
        {
          "name": "review_supplier_bills_waiting_for_approval",
          "description": "The AI lists bills by state, supplier, dates or paid status and opens one bill with its lines."
        },
        {
          "name": "check_bank_lines_and_ledger_postings",
          "description": "The AI lists the bank-statement lines of one bank account and the ledger postings for an account or period. It only reads; nothing is reconciled."
        },
        {
          "name": "add_a_customer_and_a_draft_invoice",
          "description": "The AI creates a contact, then a draft invoice for an existing contact. The draft is not sent; you approve it in Billy."
        }
      ]
    },
    "instructions": "Tools for Billy, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Which customer invoices are still unpaid and past their due date?\"; \"What did we invoice in total last month?\"; \"Show me all supplier bills from this quarter that are still waiting for approval.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Billy data. Free plan: 50 tool calls per month. Run billy_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 billy_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 billy_upgrade without a plan: it returns both plans, each with a payment link for the user to open. billy_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."
}