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 rangebluefolder_list_service_requests에서
  • LOWTool 'bluefolder_get_service_request_history' name length outside 3-30 rangebluefolder_get_service_request_history에서
  • LOWTool 'bluefolder_add_service_request_comment' name length outside 3-30 rangebluefolder_add_service_request_comment에서
  • LOWTool 'bluefolder_add_customer_comment' name length outside 3-30 rangebluefolder_add_customer_comment에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,506토큰 (도구 정의)
~1.1 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.96%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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개