ServiceBridge MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

Read work orders, invoices and customers; add leads, tasks and notes in ServiceBridge.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管型 MCP 服务器,让助手读取 ServiceBridge 外勤服务数据(客户、工单、报价、发票、付款、线索),并可新增线索、任务和备注。

可以做什么
  • 查询客户、联系人、服务地点、员工、团队和付款方式
  • 列出并查看工单、报价和发票,含其上门记录与明细行
  • 查看付款、任务、线索和活动备注,可按日期、客户或状态筛选
  • 按粒度获取某期间的发票汇总统计
  • 创建客户和线索、更新客户信息、创建任务、添加活动备注
  • 查看用量、提交功能请求、升级或取消付费方案
适用场景
适合用自然语言询问 ServiceBridge 账户情况,例如明天排了哪些工单、哪些报价未成交、上月哪些发票未付款;也适合让助手直接登记新线索、任务和备注,而无需打开应用。
运行要求
远程 streamable HTTP 端点,无需本地安装。只需填入 URL,随后通过 OAuth 登录,使用 ServiceBridge 的 API User ID 与 API User 密码(位于 Settings → Public API Settings → API Users)。客户端配置中不需要 API 密钥或 Authorization 头。
安装前请注意
有五个工具会写入账户(创建客户、更新客户、创建线索、创建任务、添加活动备注),执行前应先确认。ServiceBridge API 用户凭据在登录时输入,由托管服务按用户保存。用量按次计费:免费方案每月 50 次调用,付费方案通过 Stripe 结账链接订阅,取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ServiceBridge MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fservicebridge/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "servicebridge-by-usefulapi": {
      "type": "http",
      "url": "https://servicebridge.usefulapi.io/mcp"
    }
  }
}

README

ServiceBridge MCP by usefulapi

Use your ServiceBridge account from Claude, Cursor, or any MCP client. Read customers, work orders, estimates, invoices and tasks, and add leads, tasks and notes. Hosted, no local install: connect with your own credentials.

Live endpoint: https://servicebridge.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://servicebridge.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http servicebridge https://servicebridge.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "servicebridge": {      "url": "https://servicebridge.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your ServiceBridge credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/servicebridge/

On first connect you provide your API User ID and API User password (ServiceBridge → Settings → Public API Settings → API Users). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
servicebridge_whoamireadCurrent API user
servicebridge_list_customersreadList customers
servicebridge_get_customerreadGet customer
servicebridge_list_contactsreadList contacts
servicebridge_list_locationsreadList locations
servicebridge_list_work_ordersreadList work orders
servicebridge_get_work_orderreadGet work order
servicebridge_list_estimatesreadList estimates
servicebridge_get_estimatereadGet estimate
servicebridge_list_invoicesreadList invoices
servicebridge_get_invoicereadGet invoice
servicebridge_list_paymentsreadList payments
servicebridge_list_tasksreadList tasks
servicebridge_get_taskreadGet task
servicebridge_list_leadsreadList leads
servicebridge_get_leadreadGet lead
servicebridge_list_employeesreadList employees
servicebridge_list_activity_notesreadList activity notes
servicebridge_list_teamsreadList teams
servicebridge_list_payment_methodsreadList payment methods
servicebridge_get_invoice_statisticsreadInvoice statistics
servicebridge_create_customerwriteCreate customer
servicebridge_update_customerwriteUpdate customer
servicebridge_create_leadwriteCreate lead
servicebridge_create_taskwriteCreate task
servicebridge_add_activity_notewriteAdd activity note
servicebridge_usage_statusmetaUsage status (free-tier meter)
servicebridge_request_featuremetaRequest a missing feature
servicebridge_upgrademetaUpgrade to Pro or Pro+
servicebridge_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with servicebridge_upgrade (it returns a Stripe Checkout link). Cancel any time with servicebridge_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running servicebridge_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/servicebridge/README.md,提交 4046075

工具

26

servicebridge_whoami

Current API user

Show the API user and the account profile the connection uses. ServiceBridge REST: GET /Users/Current.

无需输入参数。

servicebridge_list_customers

List customers

List customers, with optional name or text search. ServiceBridge REST: GET /Customers.

输入参数pagepageSizechangeTimenameFiltersearchTextincludeInactiveCustomers

servicebridge_get_customer

Get customer

Get one customer by id. ServiceBridge REST: GET /Customers/{id}.

输入参数id必填includeCustomFields

servicebridge_list_contacts

List contacts

List customer contacts, optionally for one customer or location. ServiceBridge REST: GET /Contacts.

输入参数pagepageSizenameFiltercustomerFilterlocationFilterincludeLocationsincludeInactiveCustomers

servicebridge_list_locations

List locations

List service locations (job sites), optionally for one customer. ServiceBridge REST: GET /Locations.

输入参数pagepageSizebranchFiltercustomerFilterincludeContactslocationNameFilterincludeInactiveCustomers

servicebridge_list_work_orders

List work orders

List work orders, filtered by date range, customer, location or status. ServiceBridge REST: GET /WorkOrders.

输入参数pagepageSizebranchFilterdateToFilterstatusFiltercustomerFilterdateFromFilterlocationFilterinvoicedStatusFilter

servicebridge_get_work_order

Get work order

Get one work order by id, with its visits and lines. ServiceBridge REST: GET /WorkOrders/{id}.

输入参数id必填

servicebridge_list_estimates

List estimates

List estimates (quotes), filtered by date range, customer or status. ServiceBridge REST: GET /Estimates.

输入参数pagepageSizebranchFilterdateToFilterstatusFiltercustomerFilterdateFromFilter

servicebridge_get_estimate

Get estimate

Get one estimate by id, with its visits and lines. ServiceBridge REST: GET /Estimates/{id}.

输入参数id必填

servicebridge_list_invoices

List invoices

List invoices, filtered by date range, customer or status. ServiceBridge REST: GET /Invoices.

输入参数pagepageSizedateToFilterstatusFiltercustomerFilterdateFromFilterincludeDeleted

servicebridge_get_invoice

Get invoice

Get one invoice by id. ServiceBridge REST: GET /Invoices/{id}.

输入参数id必填

servicebridge_list_payments

List payments

List customer payments, filtered by date range or status. ServiceBridge REST: GET /Payments.

输入参数pagepageSizebranchFilterdateToFilterdateFromFilterpaymentStatusFiltertransactionStatusFilter

servicebridge_list_tasks

List tasks

List tasks, filtered by due date, branch, team, status or priority. ServiceBridge REST: GET /Tasks.

输入参数pagepageSizeteamFilterbranchFilterdateToFilterstatusFilterdateFromFilterpriorityFilter

servicebridge_get_task

Get task

Get one task by id. ServiceBridge REST: GET /Tasks/{id}.

输入参数id必填

servicebridge_list_leads

List leads

List sales leads, filtered by text, status, source or date. ServiceBridge REST: GET /Leads.

输入参数pagepageSizesearchFilterstatusFilterdateToUtcFilterleadSourceFilterdateFromUtcFilter

servicebridge_get_lead

Get lead

Get one sales lead by id. ServiceBridge REST: GET /Leads/{id}.

输入参数id必填

servicebridge_list_employees

List employees

List employees (technicians and staff), filtered by branch, team or status. ServiceBridge REST: GET /Employees.

输入参数pagepageSizeteamFilterbranchFilterstatusFilterlastNameFilterfirstNameFilter

servicebridge_list_activity_notes

List activity notes

List activity notes, filtered by customer, job, invoice, payment or location. ServiceBridge REST: GET /ActivityNote.

输入参数pagejobIdpageSizeinvoiceIdcustomerIdlocationIddateToFiltersearchFilterdateFromFilter

servicebridge_list_teams

List teams

List dispatch teams, optionally for one branch. ServiceBridge REST: GET /Teams.

输入参数branchId

servicebridge_list_payment_methods

List payment methods

List the payment methods set up in the account. ServiceBridge REST: GET /PaymentMethods.

无需输入参数。

servicebridge_get_invoice_statistics

Invoice statistics

Get invoice totals for a period, grouped by granularity. ServiceBridge REST: GET /Statistics/Invoices.

输入参数pagedateTo必填dateFrom必填pageSizegranularityincludeInactive

servicebridge_create_customer

Create customer

Create a customer. Writes to the account. ServiceBridge REST: POST /Customers.

输入参数NotesCompanyNameDisplayName必填CustomerTypePrivateNotes

servicebridge_update_customer

Update customer

Change a customer's name, type or notes. Only the fields you pass change. Writes to the account. ServiceBridge REST: PUT /Customers/{id}.

输入参数id必填NotesCompanyNameDisplayNameCustomerTypePrivateNotes

servicebridge_create_lead

Create lead

Create a sales lead. Writes to the account. ServiceBridge REST: POST /Leads.

输入参数CityName必填EmailNotesPhoneStateCountryZipCodeAddress1LeadSource

servicebridge_create_task

Create task

Create a task, optionally for a customer. Writes to the account. ServiceBridge REST: POST /Tasks.

输入参数NotesDueDateDueTimePriorityCustomerIdDescription必填

servicebridge_add_activity_note

Add activity note

Add an activity note to a customer, job, invoice or location. Writes to the account. ServiceBridge REST: POST /ActivityNote.

输入参数DateNote必填JobIdInvoiceIdIsFlaggedCustomerIdLocationId

版本历史

7
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成