Shop Boss MCP by usefulapi
Read repair orders, appointments, customers, vehicles, parts and shop reference data.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- LOWshopboss_list_recommended_repairs에서
- LOWshopboss_list_complaint_categories에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"shop-boss": {
"url": "https://shop-boss.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://shop-boss.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (15)
🟢shopboss_list_appointments(page, pageSize, shopId, appointmentId, firstName, ...)
Review appointments, scheduled dates, customer and vehicle references. Dates use YYYY-MM-DD. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"appointmentId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_customers(page, pageSize, shopId, customerId, firstName, ...)
Find customers by ID, name, email or phone and review their contact and account context. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"customerId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 254,
"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,}$"
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_vehicles(page, pageSize, shopId, vehicleId, customerId, ...)
Find vehicles by ID, owner, VIN, make, model or year. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"vehicleId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"customerId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"vin": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"make": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"year": {
"type": "string",
"pattern": "^\\d{4}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_repair_orders(page, pageSize, shopId, repairOrderId, customerId, ...)
Review repair orders with customer, vehicle, complaint and status context. Filter by order ID, customer or VIN. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"repairOrderId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"customerId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"vin": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"statusDateFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"statusDateTo": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_order_parts(page, pageSize, shopId, repairOrderId, partId, ...)
Review parts, quantities, prices and ordering context associated with repair orders. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"repairOrderId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"partId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"partNumber": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_parts(page, pageSize, shopId, partId, partNumber, ...)
Review inventory availability, reorder levels and part details. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"partId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"partNumber": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"category": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_part_sales(page, pageSize, shopId, partSaleId, status, ...)
Review part-sale balances and statuses without taking payments or changing sales. Part-sale IDs may be negative, as shown in the vendor reference. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"partSaleId": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"writer": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_recommended_repairs(page, pageSize, shopId, customerId, vehicleId, ...)
Review recommended or previously declined work for a customer or vehicle. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"customerId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"vehicleId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_canned_jobs(page, pageSize, shopId, cannedJobId, jobName)
Look up predefined automotive services and their pricing context. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"cannedJobId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"jobName": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_employees(page, pageSize, shopId, employeeId, firstName, ...)
Look up employee names, job descriptions, mechanic numbers and active status. Payroll, home addresses and emergency contacts are omitted. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"employeeId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"firstName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_suppliers(page, pageSize, shopId, supplierId, name)
Review supplier contact details and terms; account numbers are omitted. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
},
"supplierId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_bays(page, pageSize, shopId)
List available service bays for appointment planning. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_complaint_categories(page, pageSize, shopId)
Look up the shop's repair complaint categories. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_shop_hours(page, pageSize, shopId)
Review the shop's configured opening and closing hours. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopboss_list_sources(page, pageSize, shopId)
Review the shop's configured customer and appointment source labels. Read-only. Resource permissions depend on your Shop Boss API key.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 100000
},
"pageSize": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"shopId": {
"description": "Optional shop ID that your API key is authorized to access.",
"type": "string",
"pattern": "^[1-9]\\d{0,19}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거