{
  "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": "quaderno.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "172.67.138.37",
        "endpoints": 992,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.62.184",
        "endpoints": 992,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 992,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 992,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.138.37",
          "104.21.62.184",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-22T18:36:01.884Z",
        "last_seen": "2026-11-22T18:36:01.884Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "quaderno-mcp",
      "version": "1.41.4",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 991,
      "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": "42796",
    "server_name": "io.usefulapi/quaderno",
    "url": "https://quaderno.usefulapi.io/mcp",
    "host": "quaderno.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T18:36:01.884Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "8535bae8125c34820812e3c64bef57af5bb59b526a18320fbf75d563a8cdd6e6",
    "first_listed_at": "2026-11-22T18:36:01.884Z",
    "created_at": "2026-11-21T12:40:13.394Z",
    "resolved_addresses": [
      "172.67.138.37",
      "104.21.62.184",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/quaderno",
    "title": "Quaderno MCP by usefulapi",
    "description": "MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.",
    "version": "1.41.4",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/quaderno/",
    "published_at": "2026-11-18T11:01:49.468Z",
    "updated_at": "2026-11-18T11:01:49.468Z",
    "first_seen": "2026-11-21T12:40:12.759Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T18:36:14.789Z"
  },
  "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": 279,
    "first_check_in_window": "2026-11-22T18:36:01.884Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "8535bae8125c34820812e3c64bef57af5bb59b526a18320fbf75d563a8cdd6e6",
    "tools": 23,
    "resources": 0,
    "prompts": 6,
    "first_seen": "2026-11-22T18:36:02.170Z",
    "tool_names": [
      "quaderno_ping",
      "quaderno_calculate_tax",
      "quaderno_list_invoices",
      "quaderno_get_invoice",
      "quaderno_list_contacts",
      "quaderno_get_contact",
      "quaderno_list_items",
      "quaderno_get_item",
      "quaderno_list_credit_notes",
      "quaderno_get_credit_note",
      "quaderno_list_receipts",
      "quaderno_get_receipt",
      "quaderno_list_expenses",
      "quaderno_get_expense",
      "quaderno_list_tax_codes",
      "quaderno_list_jurisdictions",
      "quaderno_list_webhooks",
      "quaderno_request",
      "quaderno_create_contact",
      "quaderno_update_contact",
      "quaderno_create_item",
      "quaderno_create_invoice",
      "quaderno_create_transaction"
    ],
    "declared": {
      "tools": [
        {
          "name": "quaderno_ping",
          "title": "Ping (verify auth)",
          "description": "Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "Ping (verify auth)",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_calculate_tax",
          "title": "Calculate tax rate",
          "description": "Calculate the correct tax rate/amount for a sale given the customer's location and product. This is Quaderno's flagship endpoint — it applies the right VAT / GST / US sales-tax rules per jurisdiction. READ-ONLY (no record is created). Quaderno API: GET /tax_rates/calculate. Returns { name, rate, country, region, county, city, tax_code, status (taxable|non_taxable|not_registered|reverse_charge), tax_amount, subtotal, total_amount }.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "to_country"
            ],
            "properties": {
              "date": {
                "type": "string",
                "description": "Transaction date (YYYY-MM-DD); defaults to today."
              },
              "amount": {
                "type": "number",
                "description": "Transaction amount to compute the tax on."
              },
              "tax_id": {
                "type": "string",
                "description": "The customer's tax ID / VAT number (may trigger reverse-charge)."
              },
              "to_city": {
                "type": "string",
                "description": "The customer's city (recommended for US sales tax)."
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 currency code (e.g. \"USD\")."
              },
              "tax_code": {
                "type": "string",
                "description": "Product tax code, e.g. \"standard\", \"reduced\", \"exempt\", \"eservice\", \"ebook\", \"saas\", \"consulting\"."
              },
              "to_street": {
                "type": "string",
                "description": "The customer's street address (recommended for US sales tax)."
              },
              "to_country": {
                "type": "string",
                "description": "The customer's country — 2-letter ISO code (e.g. \"US\", \"DE\"). Required."
              },
              "from_country": {
                "type": "string",
                "description": "The seller's country (2-letter ISO); defaults to the account country."
              },
              "product_type": {
                "enum": [
                  "good",
                  "service"
                ],
                "type": "string",
                "description": "Whether the product is a good or a service."
              },
              "tax_behavior": {
                "enum": [
                  "inclusive",
                  "exclusive"
                ],
                "type": "string",
                "description": "Whether the amount includes tax or not."
              },
              "to_postal_code": {
                "type": "string",
                "description": "The customer's ZIP / postal code (recommended for US sales tax)."
              },
              "from_postal_code": {
                "type": "string",
                "description": "The seller's postal code."
              }
            }
          },
          "annotations": {
            "title": "Calculate tax rate",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_invoices",
          "title": "List invoices",
          "description": "List invoices, newest first, with optional filters. Quaderno API: GET /invoices. Returns invoice objects (id, number, issue_date, due_date, currency, contact, items, taxes, payments, state, total_cents, subtotal_cents), wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "description": "Search by invoice number, customer name, or PO number."
              },
              "date": {
                "type": "string",
                "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
              },
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "state": {
                "enum": [
                  "outstanding",
                  "late",
                  "uncollectible",
                  "paid"
                ],
                "type": "string",
                "description": "Filter by invoice state."
              },
              "contact": {
                "type": "string",
                "description": "Filter by customer (contact) id."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List invoices",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_invoice",
          "title": "Get an invoice",
          "description": "Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get an invoice",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_contacts",
          "title": "List contacts",
          "description": "List contacts (customers/vendors), newest first. Quaderno API: GET /contacts. Returns contact objects (id, kind, first_name, last_name, contact_name, email, country, tax_id, tax_status, …), wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "description": "Search by contact name, email, or tax ID."
              },
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List contacts",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_contact",
          "title": "Get a contact",
          "description": "Fetch a single contact by id. Quaderno API: GET /contacts/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get a contact",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_items",
          "title": "List products (items)",
          "description": "List products/items in the catalog, newest first. Quaderno API: GET /items. Returns item objects (id, code, name, kind, product_type, unit_cost, tax_class, tax_type, currency, stock, …), wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List products (items)",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_item",
          "title": "Get a product (item)",
          "description": "Fetch a single product/item by id. Quaderno API: GET /items/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get a product (item)",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_credit_notes",
          "title": "List credit notes",
          "description": "List credit notes (refund documents), newest first. Quaderno API: GET /credit_notes. Wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "description": "Search by number, customer name, or PO number."
              },
              "date": {
                "type": "string",
                "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
              },
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "contact": {
                "type": "string",
                "description": "Filter by customer (contact) id."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List credit notes",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_credit_note",
          "title": "Get a credit note",
          "description": "Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get a credit note",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_receipts",
          "title": "List receipts",
          "description": "List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "description": "Search by number or customer name."
              },
              "date": {
                "type": "string",
                "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
              },
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "contact": {
                "type": "string",
                "description": "Filter by customer (contact) id."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List receipts",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_receipt",
          "title": "Get a receipt",
          "description": "Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get a receipt",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_expenses",
          "title": "List expenses",
          "description": "List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "q": {
                "type": "string",
                "description": "Search by number or vendor name."
              },
              "date": {
                "type": "string",
                "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
              },
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Page number (legacy pagination; prefer created_before)."
              },
              "contact": {
                "type": "string",
                "description": "Filter by vendor (contact) id."
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Entries per page (1-100, default 25)."
              },
              "created_before": {
                "type": "string",
                "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
              }
            }
          },
          "annotations": {
            "title": "List expenses",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_get_expense",
          "title": "Get an expense",
          "description": "Fetch a single expense by id. Quaderno API: GET /expenses/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              }
            }
          },
          "annotations": {
            "title": "Get an expense",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_tax_codes",
          "title": "List tax codes",
          "description": "List the product tax codes Quaderno supports (id, name, description) — used as the tax_code on products / tax calculations. Quaderno API: GET /tax_codes.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List tax codes",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_jurisdictions",
          "title": "List tax jurisdictions",
          "description": "List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List tax jurisdictions",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_list_webhooks",
          "title": "List webhooks",
          "description": "List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List webhooks",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_request",
          "title": "Raw read request",
          "description": "Power-user escape hatch: GET any Quaderno API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /api (e.g. \"/tax_ids\", \"/evidence\"). Quaderno API: GET {path}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "path"
            ],
            "properties": {
              "path": {
                "type": "string",
                "description": "API path after /api, starting with a slash, e.g. \"/tax_ids\"."
              },
              "query": {
                "type": "object",
                "description": "Optional query params object.",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            }
          },
          "annotations": {
            "title": "Raw read request",
            "readOnlyHint": true
          }
        },
        {
          "name": "quaderno_create_contact",
          "title": "Create a contact",
          "description": "MUTATES Quaderno data — create a contact (customer or vendor). Provide kind plus a name; use `fields` for any other Quaderno contact attribute (phone_1, region, postal_code, city, street_line_1/2, tax_status, language, discount, notes, processor/processor_id). Quaderno API: POST /contacts. Returns the created contact.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "kind"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "company",
                  "person"
                ],
                "type": "string",
                "description": "Contact kind."
              },
              "email": {
                "type": "string",
                "description": "Contact email address."
              },
              "fields": {
                "type": "object",
                "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "tax_id": {
                "type": "string",
                "description": "The contact's tax ID / VAT number."
              },
              "country": {
                "type": "string",
                "description": "2-letter ISO country code."
              },
              "last_name": {
                "type": "string",
                "description": "The person's last name (persons only)."
              },
              "first_name": {
                "type": "string",
                "description": "For a person: their first name. For a company: the company name (Quaderno stores it here)."
              },
              "contact_name": {
                "type": "string",
                "description": "The contact person's name at a company (companies only)."
              }
            }
          },
          "annotations": {
            "title": "Create a contact",
            "destructiveHint": true
          }
        },
        {
          "name": "quaderno_update_contact",
          "title": "Update a contact",
          "description": "MUTATES Quaderno data — update an existing contact. Only the fields you pass are changed; use `fields` for any attribute not typed here. Quaderno API: PUT /contacts/{id}. Returns the updated contact.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The resource id."
              },
              "email": {
                "type": "string",
                "description": "Contact email address."
              },
              "fields": {
                "type": "object",
                "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "tax_id": {
                "type": "string",
                "description": "Tax ID / VAT number."
              },
              "country": {
                "type": "string",
                "description": "2-letter ISO country code."
              },
              "last_name": {
                "type": "string",
                "description": "Person last name."
              },
              "first_name": {
                "type": "string",
                "description": "Person first name / company name."
              },
              "contact_name": {
                "type": "string",
                "description": "Contact person at a company."
              }
            }
          },
          "annotations": {
            "title": "Update a contact",
            "destructiveHint": true
          }
        },
        {
          "name": "quaderno_create_item",
          "title": "Create a product (item)",
          "description": "MUTATES Quaderno data — create a product/item in the catalog. Provide name + unit_cost; use `fields` for any other attribute (code, description, tax_class, tax_type, currency, country, stock). Quaderno API: POST /items. Returns the created item.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "name",
              "unit_cost"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "SKU / product code."
              },
              "kind": {
                "enum": [
                  "one_off",
                  "subscription"
                ],
                "type": "string",
                "description": "Whether it is a one-off or a subscription product."
              },
              "name": {
                "type": "string",
                "description": "Product name."
              },
              "fields": {
                "type": "object",
                "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 currency code."
              },
              "unit_cost": {
                "type": "number",
                "description": "Unit price of the product."
              },
              "product_type": {
                "enum": [
                  "good",
                  "service"
                ],
                "type": "string",
                "description": "Whether the product is a good or a service."
              }
            }
          },
          "annotations": {
            "title": "Create a product (item)",
            "destructiveHint": true
          }
        },
        {
          "name": "quaderno_create_invoice",
          "title": "Create an invoice",
          "description": "MUTATES Quaderno data — create an invoice for a contact. Provide contact_id (or a contact via `fields`) and items; use `fields` for any other attribute (currency, issue_date, due_date, po_number, notes, tag_list, custom_metadata, payment_details). Each item = { description, quantity, unit_price, tax_1_name?, tax_1_rate?, discount_rate?, … }. Quaderno API: POST /invoices. Returns the created invoice (incl. permalink, pdf).",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                "description": "Line items, e.g. [{ description, quantity, unit_price, tax_1_name, tax_1_rate }]."
              },
              "notes": {
                "type": "string",
                "description": "Free-text notes on the invoice."
              },
              "fields": {
                "type": "object",
                "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 currency code."
              },
              "due_date": {
                "type": "string",
                "description": "Due date (YYYY-MM-DD)."
              },
              "po_number": {
                "type": "string",
                "description": "Purchase-order number."
              },
              "contact_id": {
                "type": "string",
                "description": "The id of an existing contact to invoice. Omit only if you pass a full `contact` object via `fields`."
              },
              "issue_date": {
                "type": "string",
                "description": "Issue date (YYYY-MM-DD)."
              }
            }
          },
          "annotations": {
            "title": "Create an invoice",
            "destructiveHint": true
          }
        },
        {
          "name": "quaderno_create_transaction",
          "title": "Create a transaction",
          "description": "MUTATES Quaderno data — record a sale or refund transaction (Quaderno computes tax and produces the compliant document). Provide the customer, items, and payment. Use `fields` for any other attribute (date, currency, shipping_address, evidence, processor, processor_id, processor_fee_cents, exchange_rate, po_number, notes, tags, custom_metadata). Quaderno API: POST /transactions. Returns the created invoice/credit-note object.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "items"
            ],
            "properties": {
              "type": {
                "enum": [
                  "sale",
                  "refund"
                ],
                "type": "string",
                "description": "Transaction type (default \"sale\")."
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                "description": "Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }]."
              },
              "fields": {
                "type": "object",
                "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "payment": {
                "type": "object",
                "description": "Payment object, e.g. { payment_method, amount, date }.",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 currency code."
              },
              "customer": {
                "type": "object",
                "description": "The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }.",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              }
            }
          },
          "annotations": {
            "title": "Create a transaction",
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with Quaderno here, with example requests to try."
        },
        {
          "name": "find_the_tax_rate_for_a_sale",
          "description": "The AI calculates the VAT, GST or US sales tax rate for a product and the customer's location. Nothing is created in your account."
        },
        {
          "name": "review_invoices_credit_notes_and_receipts",
          "description": "The AI lists your newest invoices with filters and opens one for items, taxes and payments. It also lists credit notes and receipts."
        },
        {
          "name": "list_expenses_and_the_jurisdictions_you_collect_in",
          "description": "The AI lists the expenses (bills you received) and the tax jurisdictions where your account is registered to collect tax."
        },
        {
          "name": "look_up_add_or_update_a_customer_or_vendor",
          "description": "The AI finds contacts and reads one, or creates a new customer or vendor with a name and details. It can also update an existing contact."
        },
        {
          "name": "create_products_or_invoices_or_record_sales_and_refunds",
          "description": "The AI creates an invoice for a contact with items, or records a sale or refund transaction so Quaderno computes the tax. It can add a product first."
        }
      ]
    },
    "instructions": "Tools for Quaderno, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"List the invoices we issued last month and their totals.\"; \"What tax rate applies to an ebook sold to a customer in Austin, US ZIP code 78701?\"; \"Which expenses did I record this quarter?\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Quaderno data. Free plan: 50 tool calls per month. Run quaderno_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 quaderno_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 quaderno_upgrade without a plan: it returns both plans, each with a payment link for the user to open. quaderno_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."
}