Shop Boss MCP by usefulapi

Read repair orders, appointments, customers, vehicles, parts and shop reference data.

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
74%
命名质量
77%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现(2)

  • LOWTool 'shopboss_list_recommended_repairs' name length outside 3-30 range在 shopboss_list_recommended_repairs 中
  • LOWTool 'shopboss_list_complaint_categories' name length outside 3-30 range在 shopboss_list_complaint_categories 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~3,387token 数(工具定义)
~1.6 KB典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.65%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 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"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本15 个工具