# ServiceTrade MCP connector

The ServiceTrade connector brings accounts, appointments, assets, activities and attachments to Claude, ChatGPT, Cursor, Microsoft Copilot and any MCP client, so each person asks in plain language and works inside their own ServiceTrade access.

Source: https://elaichi.ai/connectors/servicetrade/

## Facts

| | |
| --- | --- |
| Application | ServiceTrade |
| Category | CRM |
| AI tools | 381 |
| Authentication | App credentials |
| Bring your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead |

## What you can ask once ServiceTrade is connected

- Show me tomorrow's appointments for the Riverside Hospital account.
- Which assets at the Oak Street location were updated this month?
- Add a service request to Friday's appointment at Main Street Plaza.

## Connect ServiceTrade in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick ServiceTrade.
2. Optionally set Share with, then press Connect.
3. Paste your ServiceTrade app credentials. ServiceTrade authenticates the app rather than a person. One person supplies the credentials once, and everyone else works through Share with.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which ServiceTrade tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## ServiceTrade MCP connector for Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## ServiceTrade MCP connector for Claude Code

Endpoint: https://api.elaichi.ai/mcp

1. In a terminal, run `claude mcp add` with the endpoint.
2. Start Claude Code and run `/mcp`.
3. Pick elaichi, then sign in and approve in the browser.

```bash
claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp
```

Use `--scope project` instead to share it with the repository through `.mcp.json`.

## ServiceTrade MCP connector for ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web. The plugin directory lives at chatgpt.com/plugins.

## ServiceTrade MCP connector for Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## ServiceTrade MCP connector for Microsoft Copilot

Endpoint: https://api.elaichi.ai/mcp

1. In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
2. Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
3. Create a new connection, sign in and approve, then press Add to agent.
4. Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

## Connect ServiceTrade to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Every scope the client asks for starts ticked except "Delete things", which you tick yourself. Calling a ServiceTrade tool needs "Use your connected apps". Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Think hard before granting Use your connected apps, which can also delete in connected apps and cannot be undone.

## What teams do with ServiceTrade through Elaichi

### Move an appointment when a customer calls

Dispatch. Ask for tomorrow's appointments at a location, then push one to Thursday morning. The ServiceTrade appointment is updated and the change is logged under the dispatcher's name.

### Add a new asset from the site

Field operations. A technician finds a unit that was never recorded. They describe it, the asset is created in ServiceTrade against the right location, and a photo is attached in the same breath.

### Catch up on an account before a visit

Account management. Pull the account, its recent activities and upcoming appointments into one summary before you walk in, instead of clicking through five ServiceTrade screens.

### Add a service request to a booked visit

Customer service. A customer asks for one more thing while the technician is already scheduled. Add the service request to the existing ServiceTrade appointment and confirm the visit covers it.

### Tidy account settings and old attachments

Office admin. List the account settings that need a change and update them by name. Find attachments that no longer belong and remove them without digging through each record.

### Find accounts that have gone quiet

Sales. Ask which ServiceTrade accounts show no activity in the last ninety days, then draft a follow up for each one while the list is in front of you.

## Elaichi vs Zapier MCP vs Composio for ServiceTrade

All three can connect ServiceTrade to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

| What to check | Elaichi | Zapier MCP | Composio |
| --- | --- | --- | --- |
| Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. |
| Control over ServiceTrade tools | Allow or restrict single ServiceTrade tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. |
| Record of calls | One audit entry per ServiceTrade call. | A History tab of tool calls. | A log of every tool call. |
| Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. |
| Price | Free for one person; $15 per user per month on Gold. | 2 tasks per successful call. | Billed per tool call. |

Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026.

Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/).

## Frequently asked questions

### How do I connect ServiceTrade to Claude?

Two steps. In Elaichi, add the ServiceTrade connector and enter your ServiceTrade app credentials when prompted; there is no OAuth application to register and no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Sign in with your Elaichi account and ServiceTrade is available in your next conversation.

### Does ServiceTrade work with ChatGPT and Cursor as well as Claude?

Yes. ServiceTrade is connected once in Elaichi, and the same endpoint, https://api.elaichi.ai/mcp, is pasted into Claude, ChatGPT, Cursor, Microsoft Copilot or any other MCP client. The Elaichi Agent uses it too, so there is nothing separate to set up per client.

### What can an AI agent actually do with my ServiceTrade data?

It can look up and update ServiceTrade accounts, list and reschedule appointments, add service requests to a visit, create or update assets at a location, review recent activities and attach or remove files. Clients get a search step and a run step rather than a long menu, so short concrete asks such as "move the Friday appointment at Oak Street to Monday" work better than long paragraphs.

### Does connecting ServiceTrade give the AI access to every account and location?

No. Every call runs as the person who signed in, so an agent sees only the ServiceTrade accounts, appointments and assets that person can already see. Elaichi can narrow that further with roles and restrictions, and it can never widen it beyond what ServiceTrade already grants.

### Can my team share one ServiceTrade connection?

Yes. One person connects ServiceTrade in Elaichi and shares the connection with a team, and nobody else ever handles the app credentials. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person who changed an appointment or created an asset.

### Can I stop an agent from deleting or changing things in ServiceTrade?

Yes. Restrictions in Elaichi work per action, so you can restrict deleting ServiceTrade appointments or assets while leaving lookups and updates open, and you can set that on a role or on one person. A restricted action still appears in Elaichi's tool search, flagged as restricted, but no client can run it, whatever the prompt says.

### What happens to a ServiceTrade connection when someone leaves?

Offboarding that person in Elaichi ends their access to ServiceTrade through every client at once. A connection they shared with a team keeps working for everyone else. If you want ServiceTrade gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor, Microsoft Copilot and every other client.

### Does the ServiceTrade MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. ServiceTrade is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

### Is Elaichi an alternative to Zapier MCP for ServiceTrade?

Yes. Both let Claude, ChatGPT or Cursor use ServiceTrade. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every ServiceTrade call.

### How is Elaichi different from Composio for ServiceTrade?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to ServiceTrade: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

## All 381 ServiceTrade tools

Every tool below is callable through https://api.elaichi.ai/mcp once ServiceTrade is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all ServiceTrade account settings** (List). Get account settings. Returns all account settings for the current account. TimeCard-related settings are only included if the account has the TimeCard feature enabled.
- **Update a ServiceTrade account setting by ID** (Update). Update an account setting. Updates a single account setting by name. The setting name is specified in the URI path, and the new value is provided in the request body. Different settings require different permissions: - Most settings require admin.account permission - TimeCard settings require timecard.settings,… Required: id, value.
- **Get single ServiceTrade account by ID** (Get). Get a single account. Returns detailed information about a specific account. Users can only access their own account. Required: id.
- **List all ServiceTrade accounts** (List). List accounts. Returns the account for the currently authenticated user. This endpoint does not support pagination and always returns exactly one account.
- **Get single ServiceTrade activity by ID** (Get). Retrieve a single activity. Returns detailed information about a specific activity/permission. Required: id.
- **List all ServiceTrade activities** (List). List all activities. Returns all available activities (permissions) that can be assigned to user roles in your account. This endpoint does not support pagination.
- **Create a ServiceTrade appointment service request** (Create). Add a service to an appointment. Adds an existing service request to an appointment. The service request must belong to the same job as the appointment. Required: appointment_id, serviceRequestId.
- **Update a ServiceTrade appointment service request by ID** (Update). Update a service on an appointment. Updates the completion state of a service request on an appointment. Required: id, appointment_id.
- **Create a ServiceTrade appointment** (Create). Create a new appointment. Creates a new appointment for a job. Service requests can be assigned to the appointment during creation by passing their IDs in serviceRequestIds. The specified service requests must belong to the provided job. If no services are specified, the appointment is created without any services assigned. Required: jobId.
- **Delete a ServiceTrade appointment by ID** (Delete). Delete an appointment. Deletes an appointment. Only appointments with status unscheduled can be deleted; attempting to delete a scheduled or completed appointment will return a 404 error. Requires appointment.edit permission. Required: id.
- **Get single ServiceTrade appointment by ID** (Get). Get a single appointment. Retrieves detailed information about a specific appointment, including the full list of service requests to be fulfilled, assigned technicians, and the associated job details. Required: id.
- **List all ServiceTrade appointments** (List). List all appointments. Returns a paginated list of appointments matching the specified filters. By default, returns all appointments except those with status unscheduled. Sort order notes: - If lat and lon query params are provided, the default sort is ascending distance from the provided coordinates. Otherwise, the… the connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade appointment by ID** (Update). Update an appointment. Updates an existing appointment. You can modify the appointment status, time window, assigned technicians, or the list of service requests. When updating serviceRequestIds or techIds, the provided array replaces the existing assignments entirely. Required: id.
- **Get single ServiceTrade asset definition by ID** (Get). Get a single asset definition. Retrieves detailed information about a specific asset definition. The id parameter can be either a numeric ID or a type string (e.g., alarm, extinguisher, location). Required: id.
- **List all ServiceTrade asset definitions** (List). List all asset definitions. Returns a paginated list of asset definitions. By default, returns all definitions. Use query parameters to filter by account-specific activation status or current/deprecated status. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Create a ServiceTrade asset** (Create). Create an asset. Creates a new asset at the specified location. Required: type, locationId, properties.
- **Delete a ServiceTrade asset by ID** (Delete). Delete an asset. Deletes an asset. Assets that have child assets or are referenced by other entities cannot be deleted. Required: id.
- **ServiceTrade assets enable group tasking** (Enable). Enable tasking for an abstract asset group. Creates task lists for all subassets of an abstract asset group that are compatible with tasking templates in your account. The templates are automatically selected based on their coverage of the asset types within the group. Requirements: - Account must have the Tasking feature enabled - User must… Required: asset_id.
- **Get single ServiceTrade asset by ID** (Get). Get a single asset. Returns detailed information about a specific asset. Required: id.
- **List all ServiceTrade assets** (List). List assets. Returns a paginated list of assets matching the specified criteria. At least one of locationId, jobId, appointmentId, or a time-bound parameter (createdBefore, createdAfter, updatedBefore, updatedAfter, taskTemplateId) is required. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade asset by ID** (Update). Update an asset. Updates an existing asset's properties, status, parent, or task list assignment. Note: the type of an existing asset cannot be changed with a PUT request. Required: id.
- **Get single ServiceTrade attachment thumbnail by ID** (Get). Get thumbnail URLs for an attachment. Returns thumbnail URLs for an attachment. For image attachments, thumbnails are generated automatically. For avatars, small/medium/large sizes are returned. Required: id.
- **Create a ServiceTrade attachment** (Create). Upload a new attachment. Creates a new attachment by uploading a file. Important: Unlike all other endpoints, this endpoint requires multipart/form-data content type (not application/json). The file must be sent in a field named uploadedFile. Required: uploadedFile, purposeId, entityId, entityType.
- **Delete a ServiceTrade attachment by ID** (Delete). Delete an attachment. Permanently deletes an attachment. Required: id.
- **Get single ServiceTrade attachment by ID** (Get). Get a single attachment. Returns detailed information about a specific attachment. Required: id.
- **List all ServiceTrade attachments** (List). List attachments for an entity. Returns attachments for a specific entity. Required: entityId, entityType. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade attachment by ID** (Update). Update an attachment. Updates an existing attachment. You can update the description, metadata, and visibility properties. Moving Attachments: Nameplate attachments (purposeId=17) can also be moved to a different entity by providing both entityId and entityType. The user must have permission to edit attachments on both… Required: id.
- **List all ServiceTrade brands** (List). List all brands. Returns all brands. Use the name parameter to filter by brand name. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Create a ServiceTrade budget category** (Create). Create a new budget category. Creates a new budget category for a high-level budget. The budget must have status unlocked and type high_level. Required: budgetId, libItemType, cost.
- **Delete a ServiceTrade budget category by ID** (Delete). Delete a budget category. Deletes a budget category. The budget must have status unlocked. Required: id.
- **Get single ServiceTrade budget category by ID** (Get). Get a single budget category. Required: id.
- **List all ServiceTrade budget categories** (List). List budget categories. Returns budget categories matching the provided filters. At least one filter parameter (budgetId or referenceNumber) is required. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade budget category by ID** (Update). Update a budget category. Updates an existing budget category. The budget must have status unlocked. The budgetId and referenceNumber fields cannot be changed. Required: id.
- **ServiceTrade budget line items copy to job** (Copy). Copy budget line item to job item. Creates a new job item from this budget line item and links them together. This endpoint can be used on locked budgets. Required: budget_line_item_id.
- **Create a ServiceTrade budget line item** (Create). Create a budget line item. Creates a new line item on a granular budget. The budget must be in unlocked status. If libItemId is not provided, an ad-hoc item will be created using the specified serviceLineId. Required: budgetId, name, cost, quantity.
- **Delete a ServiceTrade budget line item by ID** (Delete). Delete a budget line item. Deletes an existing budget line item. The budget must be in unlocked status. Required: id.
- **Get single ServiceTrade budget line item by ID** (Get). Get a single budget line item. Returns detailed information about a specific budget line item. Required: id.
- **List all ServiceTrade budget line items** (List). List budget line items. Returns budget line items matching the provided filters. At least one filter parameter (budgetId or referenceNumber) is required. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade budget line item by ID** (Update). Update a budget line item. Updates an existing budget line item. The budget must be in unlocked status. The budgetId and referenceNumber cannot be changed. Required: id.
- **Create a ServiceTrade budget** (Create). Create a new budget. Creates a new budget or budget revision. The total is not explicitly set but calculated from budget categories (for high_level type) or budget line items (for granular type). Required: jobId, status, type.
- **Get single ServiceTrade budget by ID** (Get). Get a single budget. Returns detailed information about a specific budget version. Required: id.
- **List all ServiceTrade budgets** (List). List budgets. Returns budgets matching the specified filters. At least one filter parameter (jobId or referenceNumber) is required. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **ServiceTrade budgets revise** (Action). Revise a budget. Creates a new revision of an existing budget. Optionally applies an approved change order to the revision. Only the most current version of a budget can be revised. Voided budgets cannot be revised. When applying a change order, the budget status must be locked and the change order must be in… Required: budget_id.
- **Update a ServiceTrade budget by ID** (Update). Update a budget. Updates an existing budget. Only the current version of a budget can have its status changed. Required: id.
- **Create a ServiceTrade change order category** (Create). Create a new change order category. Creates a new change order category for a change order. The change order must be associated with a high-level budget. Action-specific requirements: - add: Requires cost and quantity; referenceNumber should not be provided - change: Requires referenceNumber; fields not provided will be populated… Required: changeOrderId, changeAction.
- **Delete a ServiceTrade change order category by ID** (Delete). Delete a change order category. Deletes a change order category. Required: id.
- **Get single ServiceTrade change order category by ID** (Get). Get a single change order category. Returns detailed information about a specific change order category. Required: id.
- **List all ServiceTrade change order categories** (List). List change order categories. Returns change order categories matching the specified filters. At least one filter parameter (changeOrderId or referenceNumber) is required. The connector pages with page / limit (limit = page size, default 100, at most 2000).
- **Update a ServiceTrade change order category by ID** (Update). Update a change order category. Updates an existing change order category. The changeOrderId, changeAction, and referenceNumber cannot be changed after creation. Required: id.
- **Create a ServiceTrade change order line item** (Create). Create a change order line item. Creates a new change order line item. The required fields depend on the changeAction: - add: Requires changeOrderId, changeAction, name, cost, and quantity. Do not provide referenceNumber. - change: Requires changeOrderId, changeAction, and referenceNumber. Fields not provided will be populated… Required: changeOrderId, changeAction.
- ...and 331 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.
