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可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

透過 MCP 用戶端讀取 ServiceTrade 的工作單、預約、缺失、報價、發票與資產等現場服務資料,並可為紀錄新增留言。

可以做什麼
  • 依狀態、客戶、技師或日期列出並篩選工作單、預約、服務請求與缺失
  • 列出並取得地點、公司、資產、合約、使用者與留言
  • 列出並取得報價與發票,含狀態、明細、總額與付款狀況
  • 為工作單、資產、發票、報價、缺失或地點新增留言
  • 查看目前連線所屬的 ServiceTrade 帳戶與使用者,查詢用量或管理訂閱
適用情境
適合用自然語言查詢 ServiceTrade 營運狀況,例如逾期工作單、某客戶據點尚未處理的缺失、未付款發票,或不必開啟 ServiceTrade 就能在紀錄上留言。
執行需求
遠端託管端點,無需本機安裝。只需填入伺服器網址,接著透過 OAuth 以 ServiceTrade 憑證登入。首次連線需提供 ServiceTrade 用戶端 ID 與用戶端密鑰(由 ServiceTrade 管理員建立的 customer 類型 API 憑證),伺服器會依使用者儲存。
安裝前請注意
新增留言工具會寫入 ServiceTrade 且非冪等,重試可能產生重複留言,使用前應先確認。ServiceTrade 用戶端 ID 與密鑰會交給第三方託管方並依使用者儲存。用量按次計費:免費方案每月 50 次呼叫,付費方案涉及 Stripe 付款連結與訂閱管理工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ServiceTrade MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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"    }  }}

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

ToolTypeWhat it does
servicetrade_list_jobsreadList jobs
servicetrade_list_locationsreadList locations
servicetrade_list_companiesreadList companies
servicetrade_list_appointmentsreadList appointments
servicetrade_list_service_requestsreadList service requests
servicetrade_list_deficienciesreadList deficiencies
servicetrade_list_assetsreadList assets
servicetrade_list_quotesreadList quotes
servicetrade_list_invoicesreadList invoices
servicetrade_list_contractsreadList contracts
servicetrade_list_usersreadList users
servicetrade_list_commentsreadList comments
servicetrade_get_jobreadGet a job
servicetrade_get_locationreadGet a location
servicetrade_get_companyreadGet a company
servicetrade_get_appointmentreadGet an appointment
servicetrade_get_deficiencyreadGet a deficiency
servicetrade_get_assetreadGet an asset
servicetrade_get_quotereadGet a quote
servicetrade_get_invoicereadGet an invoice
servicetrade_whoamireadShow the connected credential
servicetrade_add_commentwriteAdd a comment to a record
servicetrade_usage_statusmetaUsage status (free-tier meter)
servicetrade_request_featuremetaRequest a missing feature
servicetrade_upgrademetaUpgrade to Pro or Pro+
servicetrade_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 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

工具

22

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

版本歷史

8
  1. v1.6.4最新Nov 7, 2026
  2. v1.5.3Nov 5, 2026
  3. v1.5.2Nov 5, 2026
  4. v1.5.1Nov 4, 2026
  5. v1.5.0Nov 3, 2026
  6. v1.4.1Nov 3, 2026
  7. v1.3.0Nov 1, 2026
  8. v1.1.0Oct 31, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合