MCP MeasureMCP Measure

索引已觀測

BlueFolder MCP by usefulapi

Read customers, equipment and service requests; add service requests and comments in BlueFolder.

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
90%
命名品質
75%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

發現項目（4）

  • LOWTool 'bluefolder_list_service_requests' name length outside 3-30 range在 bluefolder_list_service_requests 中
  • LOWTool 'bluefolder_get_service_request_history' name length outside 3-30 range在 bluefolder_get_service_request_history 中
  • LOWTool 'bluefolder_add_service_request_comment' name length outside 3-30 range在 bluefolder_add_service_request_comment 中
  • LOWTool 'bluefolder_add_customer_comment' name length outside 3-30 range在 bluefolder_add_customer_comment 中

根據工具定義與協定合規性的自動化分析。

上下文成本

~2,506Token（工具定義）
~1.1 KB典型回應大小
中等的注意力影響（128k 上下文的 1.96%）

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案：

{
  "mcpServers": {
    "bluefolder": {
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}

遠端端點

https://bluefolder.usefulapi.io/mcpstreamable-http

它能做什麼

工具清單

工具（17）

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢bluefolder_list_customers(listType)

List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_customer(customerId, externalId)

Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "externalId": {
      "description": "Your external identifier for the customer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_service_requests(listType, customerId, customerName, customerNameExactMatch, dateField, ...)

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.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    },
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "customerName": {
      "description": "Filter by customer name.",
      "type": "string"
    },
    "customerNameExactMatch": {
      "description": "true = the name must match exactly.",
      "type": "boolean"
    },
    "dateField": {
      "description": "Date field for the range.",
      "type": "string",
      "enum": [
        "dateTimeCreated",
        "dateTimeClosed"
      ]
    },
    "startDate": {
      "description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges).",
      "type": "string"
    },
    "endDate": {
      "description": "Date and time as MM-DD-YYYY HH:MM AM/PM (the vendor's format for service request date ranges).",
      "type": "string"
    },
    "status": {
      "description": "Status to filter by, or 'open'.",
      "type": "string"
    },
    "billingStatus": {
      "description": "Billing status to filter by.",
      "type": "string"
    },
    "invoiceNo": {
      "description": "Invoice number to find.",
      "type": "string"
    },
    "referenceNo": {
      "description": "Reference number to find.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_service_request(serviceRequestId, externalId, groupItemsByType)

Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "serviceRequestId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "externalId": {
      "description": "Your external identifier for the service request.",
      "type": "string"
    },
    "groupItemsByType": {
      "description": "Group items by item type (vendor default: true).",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_service_request_history(serviceRequestId, externalId)

Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "serviceRequestId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "externalId": {
      "description": "Your external identifier for the service request.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_equipment(listType, customerId, customerExternalId)

List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    },
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "customerExternalId": {
      "description": "Your external identifier for the customer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_equipment(equipmentId)

Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "equipmentId": {
      "type": "string",
      "minLength": 1,
      "description": "Equipment GUID (from bluefolder_list_equipment)."
    }
  },
  "required": [
    "equipmentId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_contracts(listType, customerId, customerName, status)

List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    },
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "customerName": {
      "description": "Filter by customer name.",
      "type": "string"
    },
    "status": {
      "description": "Status to filter by.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_contract(contractId)

Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "contractId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    }
  },
  "required": [
    "contractId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_items(listType)

List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_item(itemId)

Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    }
  },
  "required": [
    "itemId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_users(listType)

List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "listType": {
      "description": "'basic' (default) or 'full' (more fields).",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_get_user(userId)

Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "userId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    }
  },
  "required": [
    "userId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bluefolder_list_tax_codes

List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bluefolder_add_service_request(customerId, description, detailedDescription, customerContactId, customerLocationId, ...)

Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "description": {
      "type": "string",
      "description": "Short description (the job title)."
    },
    "detailedDescription": {
      "description": "Full job description.",
      "type": "string"
    },
    "customerContactId": {
      "description": "Contact at the customer. Default: the primary contact.",
      "type": "string",
      "pattern": "^\\d+$"
    },
    "customerLocationId": {
      "description": "Location at the customer. Default: the primary location.",
      "type": "string",
      "pattern": "^\\d+$"
    },
    "dueDate": {
      "description": "Due date, as the vendor accepts it.",
      "type": "string"
    },
    "priority": {
      "description": "Priority value from your account.",
      "type": "string"
    },
    "billable": {
      "type": "boolean"
    },
    "notifyCustomer": {
      "description": "true = email the customer. Default: false.",
      "type": "boolean"
    },
    "externalId": {
      "description": "Your external identifier for the new request.",
      "type": "string"
    },
    "referenceNo": {
      "type": "string"
    },
    "purchaseOrderNo": {
      "type": "string"
    }
  },
  "required": [
    "customerId",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bluefolder_add_service_request_comment(serviceRequestId, comment, userId, commentIsPublic, notifyCustomer)

Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "serviceRequestId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "comment": {
      "type": "string",
      "description": "The comment text."
    },
    "userId": {
      "description": "The user the comment is attributed to.",
      "type": "string",
      "pattern": "^\\d+$"
    },
    "commentIsPublic": {
      "description": "true = visible to the customer.",
      "type": "boolean"
    },
    "notifyCustomer": {
      "description": "true = email the customer about the comment.",
      "type": "boolean"
    }
  },
  "required": [
    "serviceRequestId",
    "comment"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bluefolder_add_customer_comment(customerId, comment, userId)

Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.

輸入結構描述

{
  "type": "object",
  "properties": {
    "customerId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric BlueFolder id."
    },
    "comment": {
      "type": "string",
      "description": "The comment text."
    },
    "userId": {
      "description": "The user the comment is attributed to.",
      "type": "string",
      "pattern": "^\\d+$"
    }
  },
  "required": [
    "customerId",
    "comment"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本17 個工具