# ServiceTrade MCP by usefulapi

> ServiceTrade MCP by usefulapi is an MCP server. Read jobs, appointments, deficiencies, invoices and assets, and add comments in ServiceTrade. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/servicetrade/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/servicetrade
- **MCP Registry name:** io.usefulapi/servicetrade
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http servicetrade https://servicetrade.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://servicetrade.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "servicetrade": {
      "url": "https://servicetrade.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "servicetrade": {
      "type": "http",
      "url": "https://servicetrade.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "servicetrade": {
      "serverUrl": "https://servicetrade.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `servicetrade_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.
- `servicetrade_list_locations`: List customer service locations (sites) with address, company, status and tags. ServiceTrade API: GET /location.
- `servicetrade_list_companies`: List companies (customers, vendors, contractors) with city, state and status. ServiceTrade API: GET /company.
- `servicetrade_list_appointments`: List scheduled appointments (technician visits) with time window, job, location and assigned technicians. ServiceTrade API: GET /appointment.
- `servicetrade_list_service_requests`: List service requests (the work items to perform on a job, with description, service line and window). ServiceTrade API: GET /servicerequest.
- `servicetrade_list_deficiencies`: List deficiencies (problems found during inspections, such as fire or life-safety defects) with severity, status and asset. ServiceTrade API: GET /deficiency.
- `servicetrade_list_assets`: List assets (equipment such as extinguishers, panels, pumps) at customer locations with type, status and name. ServiceTrade API: GET /asset.
- `servicetrade_list_quotes`: List quotes with status, customer, location, total and expiry. ServiceTrade API: GET /quote.
- `servicetrade_list_invoices`: List invoices with status, customer, job, totals, due date and paid state. ServiceTrade API: GET /invoice.
- `servicetrade_list_contracts`: List service contracts and agreements with customer, location, review date and active state. ServiceTrade API: GET /contract.
- `servicetrade_list_users`: List users (technicians, sales staff, office staff and customer contacts) with company and status. ServiceTrade API: GET /user.
- `servicetrade_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.
- `servicetrade_get_job`: Get one job by id with customer, location, owner, appointments summary, dates and price. ServiceTrade API: GET /job/{id}.
- `servicetrade_get_location`: Get one customer location by id with address, contacts and status. ServiceTrade API: GET /location/{id}.
- `servicetrade_get_company`: Get one company by id. ServiceTrade API: GET /company/{id}.
- `servicetrade_get_appointment`: Get one appointment by id with window, technicians and job. ServiceTrade API: GET /appointment/{id}.
- `servicetrade_get_deficiency`: Get one deficiency by id with severity, status, asset and reporting job. ServiceTrade API: GET /deficiency/{id}.
- `servicetrade_get_asset`: Get one asset by id with type, location and status. ServiceTrade API: GET /asset/{id}.
- `servicetrade_get_quote`: Get one quote by id with status, line items and totals. ServiceTrade API: GET /quote/{id}.
- `servicetrade_get_invoice`: Get one invoice by id with status, items and totals. ServiceTrade API: GET /invoice/{id}.
- `servicetrade_whoami`: Show which ServiceTrade account, company, user and timezone the connected credential belongs to. ServiceTrade API: GET /oauth2/userinfo.
- `servicetrade_add_comment`: 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.

## FAQ

### How do I add ServiceTrade MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http servicetrade https://servicetrade.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/servicetrade-mcp-by-usefulapi
