ServiceTrade MCP by usefulapi

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

Read jobs, appointments, deficiencies, invoices and assets, and add comments in ServiceTrade.

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

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

服务详情

标识符: io.usefulapi/servicetrade
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 31, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 usefulapi.io，且该域名同时运行其端点。这可以确认发布者，但并不代表该服务的工具是安全的。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fservicetrade.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fservicetrade?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

通过 MCP 客户端读取 ServiceTrade 的工单、预约、缺陷、报价、发票和资产等现场服务数据，并可给记录添加评论。

可以做什么: 按状态、客户、技师或日期列出并筛选工单、预约、服务请求和缺陷
列出并获取地点、公司、资产、合同、用户和评论
列出并获取报价与发票，含状态、明细、总额和付款情况
给工单、资产、发票、报价、缺陷或地点添加评论
查看当前连接所属的 ServiceTrade 账户与用户，查询用量或管理订阅
适用场景: 适合用自然语言查询 ServiceTrade 运营情况，例如逾期工单、某客户站点上未处理的缺陷、未付款发票，或无需打开 ServiceTrade 即可在记录上留言。
运行要求: 远程托管端点，无需本地安装。只需填写服务器地址，随后通过 OAuth 使用 ServiceTrade 凭据登录。首次连接需提供 ServiceTrade 客户端 ID 和客户端密钥（由 ServiceTrade 管理员创建的 customer 类型 API 凭据），服务器按用户保存。

安装前请注意

添加评论工具会写入 ServiceTrade 且非幂等，重试可能产生重复评论，使用前应确认。ServiceTrade 客户端 ID 和密钥会交给第三方托管方并按用户存储。用量按次计费：免费方案每月 50 次调用，付费方案涉及 Stripe 支付链接和订阅管理工具。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

ServiceTrade MCP by usefulapi

Use your ServiceTrade account from Claude, Cursor, or any MCP client. It can read jobs, appointments, locations, companies, assets, deficiencies, quotes, invoices and contracts, and add a comment to a record. Hosted, no local install: connect with your own credentials.

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

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://servicetrade.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http servicetrade https://servicetrade.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": {    "servicetrade": {      "url": "https://servicetrade.usefulapi.io/mcp"    }  }}

{  "mcpServers": {    "servicetrade": {      "url": "https://servicetrade.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 ServiceTrade credentials.

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

On first connect you provide a ServiceTrade client id and client secret (API credentials of type customer, which an administrator creates in ServiceTrade). The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`servicetrade_list_jobs`	read	List jobs
`servicetrade_list_locations`	read	List locations
`servicetrade_list_companies`	read	List companies
`servicetrade_list_appointments`	read	List appointments
`servicetrade_list_service_requests`	read	List service requests
`servicetrade_list_deficiencies`	read	List deficiencies
`servicetrade_list_assets`	read	List assets
`servicetrade_list_quotes`	read	List quotes
`servicetrade_list_invoices`	read	List invoices
`servicetrade_list_contracts`	read	List contracts
`servicetrade_list_users`	read	List users
`servicetrade_list_comments`	read	List comments
`servicetrade_get_job`	read	Get a job
`servicetrade_get_location`	read	Get a location
`servicetrade_get_company`	read	Get a company
`servicetrade_get_appointment`	read	Get an appointment
`servicetrade_get_deficiency`	read	Get a deficiency
`servicetrade_get_asset`	read	Get an asset
`servicetrade_get_quote`	read	Get a quote
`servicetrade_get_invoice`	read	Get an invoice
`servicetrade_whoami`	read	Show the connected credential
`servicetrade_add_comment`	write	Add a comment to a record
`servicetrade_usage_status`	meta	Usage status (free-tier meter)
`servicetrade_request_feature`	meta	Request a missing feature
`servicetrade_upgrade`	meta	Upgrade to Pro or Pro+
`servicetrade_cancel_subscription`	meta	Cancel 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

*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 servicetrade_upgrade (it returns a Stripe Checkout link). Cancel any time with servicetrade_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running servicetrade_upgrade before then undoes the cancel. Or write to [email protected].

License

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

来源：servers/servicetrade/README.md，提交 4046075

工具

servicetrade_list_jobs

List jobs

List jobs (service calls, inspections, installs) with status, type, customer, location, owner, due date and estimated price. Filter by status, type, location, customer, technician, due or completion dates. ServiceTrade API: GET /job.

输入参数namepagesorttypelimitnumberstatustechIddueByEndsortOrdercustomerIddueByBegin另有 5 个

servicetrade_list_locations

List locations

List customer service locations (sites) with address, company, status and tags. ServiceTrade API: GET /location.

输入参数namepagelimitstatuscompanyIdupdatedAfter

servicetrade_list_companies

List companies

List companies (customers, vendors, contractors) with city, state and status. ServiceTrade API: GET /company.

输入参数citynamepagelimitstatestatusisCustomerupdatedAfter

servicetrade_list_appointments

List appointments

List scheduled appointments (technician visits) with time window, job, location and assigned technicians. ServiceTrade API: GET /appointment.

输入参数pagejobIdlimitstatustechIdslocationIdwindowBeginsAfterwindowBeginsBefore

servicetrade_list_service_requests

List service requests

List service requests (the work items to perform on a job, with description, service line and window). ServiceTrade API: GET /servicerequest.

输入参数pagejobIdlimitstatuslocationId

servicetrade_list_deficiencies

List deficiencies

List deficiencies (problems found during inspections, such as fire or life-safety defects) with severity, status and asset. ServiceTrade API: GET /deficiency.

输入参数pagelimitstatusassetIdseveritycompanyIdlocationIdcreatedAfter

servicetrade_list_assets

List assets

List assets (equipment such as extinguishers, panels, pumps) at customer locations with type, status and name. ServiceTrade API: GET /asset.

输入参数namepagetypejobIdlimitsearchstatuslocationId

servicetrade_list_quotes

List quotes

List quotes with status, customer, location, total and expiry. ServiceTrade API: GET /quote.

输入参数pagesortjobIdlimitstatussortOrdercustomerIdlocationIdcreatedAfter

servicetrade_list_invoices

List invoices

List invoices with status, customer, job, totals, due date and paid state. ServiceTrade API: GET /invoice.

输入参数pagepaidsortjobIdlimitstatussortOrdercustomerIdlocationIdcreatedAftertransactionDateAftertransactionDateBefore

servicetrade_list_contracts

List contracts

List service contracts and agreements with customer, location, review date and active state. ServiceTrade API: GET /contract.

输入参数namepagelimitactivecustomerIdlocationId

servicetrade_list_users

List users

List users (technicians, sales staff, office staff and customer contacts) with company and status. ServiceTrade API: GET /user.

输入参数namepagelimitisTechsearchstatuscompanyId

servicetrade_list_comments

List comments

List comments on one record. Pass the entity type number and the record id (Asset 2, Job 3, Invoice 6, Quote 9, Deficiency 10, Location 11). ServiceTrade API: GET /comment.

输入参数pagelimitentityIdentityTypevisibilitycreatedAfter

servicetrade_get_job

Get a job

Get one job by id with customer, location, owner, appointments summary, dates and price. ServiceTrade API: GET /job/{id}.

输入参数id必填

servicetrade_get_location

Get a location

Get one customer location by id with address, contacts and status. ServiceTrade API: GET /location/{id}.

输入参数id必填

servicetrade_get_company

Get a company

Get one company by id. ServiceTrade API: GET /company/{id}.

输入参数id必填

servicetrade_get_appointment

Get an appointment

Get one appointment by id with window, technicians and job. ServiceTrade API: GET /appointment/{id}.

输入参数id必填

servicetrade_get_deficiency

Get a deficiency

Get one deficiency by id with severity, status, asset and reporting job. ServiceTrade API: GET /deficiency/{id}.

输入参数id必填

servicetrade_get_asset

Get an asset

Get one asset by id with type, location and status. ServiceTrade API: GET /asset/{id}.

输入参数id必填

servicetrade_get_quote

Get a quote

Get one quote by id with status, line items and totals. ServiceTrade API: GET /quote/{id}.

输入参数id必填

servicetrade_get_invoice

Get an invoice

Get one invoice by id with status, items and totals. ServiceTrade API: GET /invoice/{id}.

输入参数id必填

servicetrade_whoami

Show the connected credential

Show which ServiceTrade account, company, user and timezone the connected credential belongs to. ServiceTrade API: GET /oauth2/userinfo.

无需输入参数。

servicetrade_add_comment

Add a comment to a record

WRITE: add a new comment to a job, asset, invoice, quote, deficiency or location. Each call creates one more comment (not idempotent: do not retry blindly). ServiceTrade API: POST /comment.

输入参数content必填entityId必填entityType必填visibility