Shop Boss MCP by usefulapi
Read repair orders, appointments, customers, vehicles, parts and shop reference data.
我该使用它吗
质量与安全性
发现(2)
- LOW在 shopboss_list_recommended_repairs 中
- LOW在 shopboss_list_complaint_categories 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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"
}社区
证据