{
  "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": "bilflo.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 891,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 891,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 891,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 891,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.62.184",
          "172.67.138.37",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-21T19:33:01.292Z",
        "last_seen": "2026-11-21T19:33:01.292Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "bilflo-mcp",
      "version": "1.20.4",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 890,
      "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": 1101,
      "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": 1101,
      "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": 1101,
      "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": "42170",
    "server_name": "io.usefulapi/bilflo",
    "url": "https://bilflo.usefulapi.io/mcp",
    "host": "bilflo.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T19:33:01.292Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "d61d716d2c79bc619ea4d8ead11a241f089eb2a60ff1f44628d7120dc8e77888",
    "first_listed_at": "2026-11-21T19:33:01.292Z",
    "created_at": "2026-11-21T12:35:10.200Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/bilflo",
    "title": "Bilflo MCP by usefulapi",
    "description": "Read Bilflo clients, contract jobs, contractors and reports; update jobs, terminate or reopen them.",
    "version": "1.20.4",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/bilflo/",
    "published_at": "2026-11-18T11:02:33.611Z",
    "updated_at": "2026-11-18T11:02:33.611Z",
    "first_seen": "2026-11-21T12:35:09.514Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "reads-chain"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:59:15.668Z"
  },
  "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": 190,
    "first_check_in_window": "2026-11-21T19:33:01.292Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "d61d716d2c79bc619ea4d8ead11a241f089eb2a60ff1f44628d7120dc8e77888",
    "tools": 26,
    "resources": 0,
    "prompts": 7,
    "first_seen": "2026-11-21T19:33:01.489Z",
    "tool_names": [
      "bilflo_list_clients",
      "bilflo_get_client",
      "bilflo_list_client_contacts",
      "bilflo_list_client_addresses",
      "bilflo_list_client_agreements",
      "bilflo_list_client_contract_pos",
      "bilflo_list_client_invoice_groups",
      "bilflo_get_contract_job",
      "bilflo_list_job_pay_bill_items",
      "bilflo_list_job_approvers",
      "bilflo_list_job_purchase_orders",
      "bilflo_get_job_custom_fields",
      "bilflo_get_direct_hire",
      "bilflo_get_contractor",
      "bilflo_get_team_member",
      "bilflo_list_overtime_rules",
      "bilflo_get_company_setting",
      "bilflo_list_custom_fields",
      "bilflo_list_custom_field_items",
      "bilflo_run_report",
      "bilflo_create_client",
      "bilflo_update_client",
      "bilflo_update_contract_job",
      "bilflo_terminate_contract_job",
      "bilflo_reopen_contract_job",
      "bilflo_update_contractor"
    ],
    "declared": {
      "tools": [
        {
          "name": "bilflo_list_clients",
          "title": "List clients",
          "description": "The staffing company's clients (the customers contractors are placed with): id, business name, client code, phone, active flag. Each row carries the number of addresses and contacts; set include_details for the full address and contact lists. Bilflo returns every client at once, so this tool filters and pages the list itself. GET /v1/Clients.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 200,
                "description": "Rows to return, 1-200 (default 50).",
                "exclusiveMinimum": 0
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Rows to skip (default 0). Bilflo does not page, so the list is cut here."
              },
              "search": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Only clients whose business name or client code contains this text (case-insensitive)."
              },
              "active_only": {
                "type": "boolean",
                "description": "Only active clients."
              },
              "include_details": {
                "type": "boolean",
                "description": "Include each client's addresses and contacts (large; use with a small limit)."
              }
            }
          },
          "annotations": {
            "title": "List clients",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_client",
          "title": "Get client",
          "description": "One client with its addresses and contacts. GET /v1/Clients/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id (from bilflo_list_clients).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get client",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_client_contacts",
          "title": "List client contacts",
          "description": "The contacts (people at the client: name, title, phone, email, active flag) of one client. GET /v1/Clients/contact/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List client contacts",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_client_addresses",
          "title": "List client addresses",
          "description": "The addresses (work sites and billing addresses) of one client. GET /v1/Clients/addresses/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List client addresses",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_client_agreements",
          "title": "List client agreements",
          "description": "The agreements (billing terms) on file for one client. GET /v1/Clients/agreements/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List client agreements",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_client_contract_pos",
          "title": "List client contract POs",
          "description": "The contract purchase orders of one client (PO numbers and amounts used for billing). GET /v1/Clients/contractPOs/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List client contract POs",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_client_invoice_groups",
          "title": "List client invoice groups",
          "description": "The contract invoice groups of one client (which jobs are invoiced together). GET /v1/Clients/contractInvoiceGroups/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List client invoice groups",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_contract_job",
          "title": "Get contract job",
          "description": "One contract job (a contractor placed with a client): client, contractor, title, start/end dates, status, overtime rule, timecard method, per-diem/expense/sick-time flags, workers' comp code and burden. GET /v1/ContractJobs/{jobId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get contract job",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_job_pay_bill_items",
          "title": "List job pay/bill items",
          "description": "The pay and bill rates (pay/bill items such as Regular, Overtime) of one contract job. GET /v1/ContractJobs/{jobId}/payBillItems.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List job pay/bill items",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_job_approvers",
          "title": "List job approvers",
          "description": "Who approves the timecards of one contract job. GET /v1/ContractJobs/{jobId}/approvers.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List job approvers",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_job_purchase_orders",
          "title": "List job purchase orders",
          "description": "The purchase orders attached to one contract job. GET /v1/ContractJobs/{jobId}/purchaseOrders.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List job purchase orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_job_custom_fields",
          "title": "Get job custom fields",
          "description": "The custom field values of one contract job. GET /v1/ContractJobs/{jobId}/customFields.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get job custom fields",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_direct_hire",
          "title": "Get direct hire",
          "description": "One direct hire (a permanent placement): header, fee/split data, contacts and custom fields as Bilflo returns them. GET /v1/DirectHires/{jobId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo direct hire job id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get direct hire",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_contractor",
          "title": "Get contractor",
          "description": "One contractor: profile (name, email, phone, address, W2/1099), jobs, checks paid, work status, benefit settings and custom fields. Social security number, date of birth and bank details are removed from the reply. GET /v1/Users/contractors/{contractorId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "contractor_id"
            ],
            "properties": {
              "contractor_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contractor id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get contractor",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_team_member",
          "title": "Get team member",
          "description": "One back-office team member (staffing company user): profile, roles and compensation settings. Government ids and bank details are removed. GET /v1/Users/teamMember/{id}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "team_member_id"
            ],
            "properties": {
              "team_member_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo team member (user) id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get team member",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_overtime_rules",
          "title": "List overtime rules",
          "description": "The company's overtime rules (id, name, state). Use the ids with bilflo_update_contract_job. GET /v1/OvertimeRules.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List overtime rules",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_get_company_setting",
          "title": "Get company setting",
          "description": "One of the company's lookup lists: workers_comp_codes, payment_terms, remittances, burden_settings, benefit_rules, states or pay_bill_items. GET /v1/CompanySettings/{setting}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "setting"
            ],
            "properties": {
              "setting": {
                "enum": [
                  "workers_comp_codes",
                  "payment_terms",
                  "remittances",
                  "burden_settings",
                  "benefit_rules",
                  "states",
                  "pay_bill_items"
                ],
                "type": "string",
                "description": "Which list to read."
              }
            }
          },
          "annotations": {
            "title": "Get company setting",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_custom_fields",
          "title": "List custom fields",
          "description": "The company's custom fields (active and inactive) with type, requiredness per service offering and, for list fields, the selectable items. GET /v1/CustomFields.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List custom fields",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_list_custom_field_items",
          "title": "List custom field items",
          "description": "The selectable items of one custom list field (id from bilflo_list_custom_fields). Items of a field named like personal data (SSN, date of birth, bank account, password) are not shown. GET /v1/CustomFields/items.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "custom_field_id"
            ],
            "properties": {
              "custom_field_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Custom field id (from bilflo_list_custom_fields).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "List custom field items",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_run_report",
          "title": "Run custom report",
          "description": "Run one of the company's saved custom reports and return its rows. Report parameters are report specific key/value pairs, for example {\"Start\": \"2026-01-01\", \"End\": \"2026-01-31\"}. Reads data only. POST /v1/Reports/{reportId}/Execute.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "report_id"
            ],
            "properties": {
              "report_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo custom report id.",
                "exclusiveMinimum": 0
              },
              "parameters": {
                "type": "object",
                "description": "Report parameters as key/value pairs.",
                "propertyNames": {
                  "type": "string",
                  "maxLength": 60,
                  "minLength": 1
                },
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 500
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    }
                  ]
                }
              }
            }
          },
          "annotations": {
            "title": "Run custom report",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_create_client",
          "title": "Create client",
          "description": "WRITE: creates a new client (customer) in Bilflo with the given business name and returns its id. It is visible to the whole staffing company and used for billing, so check bilflo_list_clients first to avoid a duplicate. POST /v1/Clients.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "business_name"
            ],
            "properties": {
              "business_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Business name of the new client."
              }
            }
          },
          "annotations": {
            "title": "Create client",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_update_client",
          "title": "Update client",
          "description": "WRITE: changes only the client fields you pass (business name, client code, phone, fax, active flag); the rest stay as they are. Setting is_active=false deactivates the client. PATCH /v1/Clients/{clientId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "client_id"
            ],
            "properties": {
              "fax": {
                "type": "string",
                "maxLength": 40,
                "minLength": 1
              },
              "phone": {
                "type": "string",
                "maxLength": 40,
                "minLength": 1
              },
              "client_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo client id.",
                "exclusiveMinimum": 0
              },
              "is_active": {
                "type": "boolean",
                "description": "false deactivates the client, true reactivates it."
              },
              "client_code": {
                "type": "string",
                "maxLength": 50,
                "minLength": 1
              },
              "business_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              }
            }
          },
          "annotations": {
            "title": "Update client",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "bilflo_update_contract_job",
          "title": "Update contract job",
          "description": "WRITE: changes only the contract job fields you pass (title, overtime rule, workers' comp code, burden, per-diem/expenses/sick-time/meal-period flags); the rest stay as they are. Pay and bill rates change payroll and invoices, so confirm values with the user. Client, contractor, dates and status cannot be changed here. PATCH /v1/ContractJobs/{jobId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              },
              "job_title": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "burden_manual": {
                "type": "number",
                "maximum": 1000,
                "minimum": 0,
                "description": "Manual burden value."
              },
              "overtime_rule_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Overtime rule id (bilflo_list_overtime_rules).",
                "exclusiveMinimum": 0
              },
              "is_allow_skip_lunch": {
                "type": "boolean"
              },
              "is_expenses_enabled": {
                "type": "boolean"
              },
              "is_per_diem_enabled": {
                "type": "boolean"
              },
              "is_sick_time_enabled": {
                "type": "boolean"
              },
              "is_waive_meal_period": {
                "type": "boolean"
              },
              "workers_comp_code_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Workers' comp code id (bilflo_get_company_setting workers_comp_codes).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Update contract job",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "bilflo_terminate_contract_job",
          "title": "Terminate contract job",
          "description": "WRITE: ends a contract job on the given date (the contractor stops being placed with the client; no more timecards are expected after it). Affects payroll and invoicing. A terminated job can be brought back with bilflo_reopen_contract_job. POST /v1/ContractJobs/terminate.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id",
              "end_date"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              },
              "end_date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Last day of the job, yyyy-mm-dd."
              }
            }
          },
          "annotations": {
            "title": "Terminate contract job",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "bilflo_reopen_contract_job",
          "title": "Reopen contract job",
          "description": "WRITE: reopens a terminated contract job (like the Open Job button): the job becomes active again, the end date is cleared, the contractor is made active and the missing timecards from the reopen date's week are created. Fails if the job is not terminated or the company plan has no room for another active job. POST /v1/ContractJobs/{jobId}/reopen.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "job_id",
              "reopen_date"
            ],
            "properties": {
              "job_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contract job id.",
                "exclusiveMinimum": 0
              },
              "reopen_date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Date to reopen from, yyyy-mm-dd (not before the job start)."
              }
            }
          },
          "annotations": {
            "title": "Reopen contract job",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "bilflo_update_contractor",
          "title": "Update contractor contact details",
          "description": "WRITE: changes only the contractor contact fields you pass (name, title, email, phone, address, company); the rest stay as they are. Tax, bank, social security number and activation are not changeable here. PATCH /v1/Users/contractors/{contractorId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "contractor_id"
            ],
            "properties": {
              "city": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "phone": {
                "type": "string",
                "maxLength": 40,
                "minLength": 1
              },
              "title": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "address1": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "address2": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "zip_code": {
                "type": "string",
                "maxLength": 20,
                "minLength": 1
              },
              "last_name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "phone_ext": {
                "type": "string",
                "maxLength": 20,
                "minLength": 1
              },
              "first_name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "state_code": {
                "type": "string",
                "maxLength": 2,
                "minLength": 2,
                "description": "Two-letter state code."
              },
              "middle_name": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "contractor_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Bilflo contractor id.",
                "exclusiveMinimum": 0
              },
              "email_address": {
                "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": 256
              },
              "contractor_company": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The contractor's own company name (1099)."
              }
            }
          },
          "annotations": {
            "title": "Update contractor contact details",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with Bilflo here, with example requests to try."
        },
        {
          "name": "list_our_clients_and_their_contacts",
          "description": "Lists clients with business name, client code and active flag, opens one client with its addresses and contacts, and lists a client's contacts."
        },
        {
          "name": "show_a_contract_job_with_its_pay_and_bill_rates",
          "description": "Reads a contract job with client, contractor, dates and status, its pay and bill items such as Regular and Overtime, and who approves the timecards."
        },
        {
          "name": "check_a_client_s_billing_setup",
          "description": "Lists a client's agreements, contract purchase orders, invoice groups and addresses, so you can see the billing terms in one place."
        },
        {
          "name": "run_a_saved_custom_report",
          "description": "Runs one of the company's saved custom reports with the parameters you give, such as a start and end date, and returns its rows."
        },
        {
          "name": "update_terminate_or_reopen_a_contract_job",
          "description": "Changes a job's title, overtime rule or flags, ends it on a date, or reopens a terminated job. Overtime rules can be listed first."
        },
        {
          "name": "add_or_update_a_client",
          "description": "Creates a client with a business name, or changes a client's name, code, phone or active flag."
        }
      ]
    },
    "instructions": "Tools for Bilflo, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"List my active clients and how many contacts each one has.\"; \"Show contract job 5821 with its pay and bill rates.\"; \"Run custom report 12 for January 2026.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Bilflo data. Free plan: 50 tool calls per month. Run bilflo_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 bilflo_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 bilflo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bilflo_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."
}