{
  "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": "bluefolder.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 720,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 720,
        "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": 720,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 720,
        "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:50:00.709Z",
        "last_seen": "2026-11-21T19:50:00.709Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "bluefolder-mcp",
      "version": "1.8.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 719,
      "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": 1096,
      "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": 1096,
      "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": 1096,
      "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": "42187",
    "server_name": "io.usefulapi/bluefolder",
    "url": "https://bluefolder.usefulapi.io/mcp",
    "host": "bluefolder.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T19:50:00.709Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "79d338efba372188ab699b9d8d49bd2ca746112c3cffd645065b4badf1cdc23a",
    "first_listed_at": "2026-11-21T19:50:00.709Z",
    "created_at": "2026-11-21T12:35:10.980Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/bluefolder",
    "title": "BlueFolder MCP by usefulapi",
    "description": "Read customers, equipment and service requests; add service requests and comments in BlueFolder.",
    "version": "1.8.0",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/bluefolder/",
    "published_at": "2026-11-21T01:01:45.565Z",
    "updated_at": "2026-11-21T01:01:45.565Z",
    "first_seen": "2026-11-21T12:35:10.354Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "reads-chain"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:54:06.924Z"
  },
  "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": 227,
    "first_check_in_window": "2026-11-21T19:50:00.709Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "79d338efba372188ab699b9d8d49bd2ca746112c3cffd645065b4badf1cdc23a",
    "tools": 17,
    "resources": 0,
    "prompts": 6,
    "first_seen": "2026-11-21T19:50:00.940Z",
    "tool_names": [
      "bluefolder_list_customers",
      "bluefolder_get_customer",
      "bluefolder_list_service_requests",
      "bluefolder_get_service_request",
      "bluefolder_get_service_request_history",
      "bluefolder_list_equipment",
      "bluefolder_get_equipment",
      "bluefolder_list_contracts",
      "bluefolder_get_contract",
      "bluefolder_list_items",
      "bluefolder_get_item",
      "bluefolder_list_users",
      "bluefolder_get_user",
      "bluefolder_list_tax_codes",
      "bluefolder_add_service_request",
      "bluefolder_add_service_request_comment",
      "bluefolder_add_customer_comment"
    ],
    "declared": {
      "tools": [
        {
          "name": "bluefolder_list_customers",
          "title": "List customers",
          "description": "List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              }
            }
          },
          "annotations": {
            "title": "List customers",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_customer",
          "title": "Get a customer",
          "description": "Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              },
              "externalId": {
                "type": "string",
                "description": "Your external identifier for the customer."
              }
            }
          },
          "annotations": {
            "title": "Get a customer",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_service_requests",
          "title": "List service requests",
          "description": "List service requests (jobs), optionally filtered by customer, status, billing status, invoice or reference number, or a created/closed date range. Use status 'open' for all non-closed requests. BlueFolder API: POST /serviceRequests/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "Status to filter by, or 'open'."
              },
              "endDate": {
                "type": "string",
                "description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges)."
              },
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              },
              "dateField": {
                "enum": [
                  "dateTimeCreated",
                  "dateTimeClosed"
                ],
                "type": "string",
                "description": "Date field for the range."
              },
              "invoiceNo": {
                "type": "string",
                "description": "Invoice number to find."
              },
              "startDate": {
                "type": "string",
                "description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges)."
              },
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              },
              "referenceNo": {
                "type": "string",
                "description": "Reference number to find."
              },
              "customerName": {
                "type": "string",
                "description": "Filter by customer name."
              },
              "billingStatus": {
                "type": "string",
                "description": "Billing status to filter by."
              },
              "customerNameExactMatch": {
                "type": "boolean",
                "description": "true = the name must match exactly."
              }
            }
          },
          "annotations": {
            "title": "List service requests",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_service_request",
          "title": "Get a service request",
          "description": "Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "externalId": {
                "type": "string",
                "description": "Your external identifier for the service request."
              },
              "groupItemsByType": {
                "type": "boolean",
                "description": "Group items by item type (vendor default: true)."
              },
              "serviceRequestId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Get a service request",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_service_request_history",
          "title": "Get service request history",
          "description": "Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "externalId": {
                "type": "string",
                "description": "Your external identifier for the service request."
              },
              "serviceRequestId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Get service request history",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_equipment",
          "title": "List equipment",
          "description": "List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              },
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              },
              "customerExternalId": {
                "type": "string",
                "description": "Your external identifier for the customer."
              }
            }
          },
          "annotations": {
            "title": "List equipment",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_equipment",
          "title": "Get equipment",
          "description": "Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "equipmentId"
            ],
            "properties": {
              "equipmentId": {
                "type": "string",
                "minLength": 1,
                "description": "Equipment GUID (from bluefolder_list_equipment)."
              }
            }
          },
          "annotations": {
            "title": "Get equipment",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_contracts",
          "title": "List contracts",
          "description": "List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "status": {
                "type": "string",
                "description": "Status to filter by."
              },
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              },
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              },
              "customerName": {
                "type": "string",
                "description": "Filter by customer name."
              }
            }
          },
          "annotations": {
            "title": "List contracts",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_contract",
          "title": "Get a contract",
          "description": "Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "contractId"
            ],
            "properties": {
              "contractId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Get a contract",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_items",
          "title": "List items",
          "description": "List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              }
            }
          },
          "annotations": {
            "title": "List items",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_item",
          "title": "Get an item",
          "description": "Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "itemId"
            ],
            "properties": {
              "itemId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Get an item",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_users",
          "title": "List users",
          "description": "List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "listType": {
                "enum": [
                  "basic",
                  "full"
                ],
                "type": "string",
                "description": "'basic' (default) or 'full' (more fields)."
              }
            }
          },
          "annotations": {
            "title": "List users",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_get_user",
          "title": "Get a user",
          "description": "Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "userId"
            ],
            "properties": {
              "userId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Get a user",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_list_tax_codes",
          "title": "List tax codes",
          "description": "List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List tax codes",
            "readOnlyHint": true
          }
        },
        {
          "name": "bluefolder_add_service_request",
          "title": "Create a service request",
          "description": "Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customerId",
              "description"
            ],
            "properties": {
              "dueDate": {
                "type": "string",
                "description": "Due date, as the vendor accepts it."
              },
              "billable": {
                "type": "boolean"
              },
              "priority": {
                "type": "string",
                "description": "Priority value from your account."
              },
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              },
              "externalId": {
                "type": "string",
                "description": "Your external identifier for the new request."
              },
              "description": {
                "type": "string",
                "description": "Short description (the job title)."
              },
              "referenceNo": {
                "type": "string"
              },
              "notifyCustomer": {
                "type": "boolean",
                "description": "true = email the customer. Default: false."
              },
              "purchaseOrderNo": {
                "type": "string"
              },
              "customerContactId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Contact at the customer. Default: the primary contact."
              },
              "customerLocationId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Location at the customer. Default: the primary location."
              },
              "detailedDescription": {
                "type": "string",
                "description": "Full job description."
              }
            }
          },
          "annotations": {
            "title": "Create a service request",
            "destructiveHint": true
          }
        },
        {
          "name": "bluefolder_add_service_request_comment",
          "title": "Add a service request comment",
          "description": "Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "serviceRequestId",
              "comment"
            ],
            "properties": {
              "userId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "The user the comment is attributed to."
              },
              "comment": {
                "type": "string",
                "description": "The comment text."
              },
              "notifyCustomer": {
                "type": "boolean",
                "description": "true = email the customer about the comment."
              },
              "commentIsPublic": {
                "type": "boolean",
                "description": "true = visible to the customer."
              },
              "serviceRequestId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Add a service request comment",
            "destructiveHint": true
          }
        },
        {
          "name": "bluefolder_add_customer_comment",
          "title": "Add a customer comment",
          "description": "Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customerId",
              "comment"
            ],
            "properties": {
              "userId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "The user the comment is attributed to."
              },
              "comment": {
                "type": "string",
                "description": "The comment text."
              },
              "customerId": {
                "type": "string",
                "pattern": "^\\d+$",
                "description": "Numeric BlueFolder id."
              }
            }
          },
          "annotations": {
            "title": "Add a customer comment",
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with BlueFolder here, with example requests to try."
        },
        {
          "name": "look_up_a_customer_s_open_service_requests",
          "description": "Look up a customer, then list their open service requests. Open one request to read its items, labor and billing totals."
        },
        {
          "name": "check_equipment_service_dates_before_a_visit",
          "description": "List the equipment of one customer. Open one unit to read its service dates and notes."
        },
        {
          "name": "review_service_contracts_and_their_balances",
          "description": "List the service contracts by customer or status. Open one contract to read its balances, billing details and limits."
        },
        {
          "name": "read_the_history_of_a_service_request",
          "description": "Read the history and comments of one service request, by its id or its external id."
        },
        {
          "name": "log_a_new_job_and_its_comments",
          "description": "Create a service request for a customer and add comments to it. Customer emails are sent only when notifyCustomer is set to true."
        }
      ]
    },
    "instructions": "Tools for BlueFolder, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Which service requests are still open for our biggest customer?\"; \"Show the equipment at this customer and when each unit is due for service.\"; \"Create a service request for a broken chiller at the Acme site, without emailing the customer.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes BlueFolder data. Free plan: 50 tool calls per month. Run bluefolder_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 bluefolder_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 bluefolder_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bluefolder_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."
}