Skip to main content
Glama
ServiceTitan MCP

ServiceTitan MCP

ServiceTitan MCP Server

CI npm version License: MIT MCP Tools Domains

The only MCP server for the ServiceTitan API — 467 tools across 15 domains, plus 10 intelligence tools that turn raw API data into business decisions.

Built by Rowvyn — See the case study →


Why

  • ServiceTitan has no official MCP server or developer tooling beyond REST docs

  • Raw API access is friction-heavy — OAuth token management, module-prefix routing, pagination, and response parsing all fall on you

  • This server handles all of that and adds 10 intelligence tools that aggregate multiple endpoints into operational insights

  • Dashboard-matched revenue — verified on production data using the same Reporting API source that powers ST's own dashboard


Related MCP server: servicetitan-mcp

Features

  • 467 tools across 15 domains — CRM, dispatch, accounting, payroll, inventory, marketing, and more

  • 10 intelligence tools — composite analytics that aggregate multiple API calls into revenue summaries, ops snapshots, technician scorecards, and more

  • Dashboard-matched revenue — intel_revenue_summary pulls from the same source as ST's own dashboard

  • Read-only by default — ST_READONLY=true out of the box; write tools only activate when you're ready

  • Safety layer — confirmation workflow for writes/deletes, audit logging with sensitive field redaction

  • Domain filtering — expose only the tool groups you need via ST_DOMAINS

  • Name-based filtering — pass businessUnitName or technicianName instead of numeric IDs; resolved via 30-minute cache

  • LLM-optimized responses — response shaping trims API noise and structures data for AI consumption

  • Streamable HTTP remote deployment — deploy to Fly.io (or anywhere) and connect via mcp-remote

  • Built-in health check — st_health_check validates auth and tenant access (no config details exposed)


Quick Start

Prerequisites

  • Node.js 22 or newer

  • ServiceTitan API credentials: Client ID, Client Secret, App Key, Tenant ID

No install needed — runs directly:

{
  "mcpServers": {
    "servicetitan": {
      "command": "npx",
      "args": ["-y", "@rowvyn/servicetitan-mcp"],
      "env": {
        "ST_CLIENT_ID": "your-client-id",
        "ST_CLIENT_SECRET": "your-client-secret",
        "ST_APP_KEY": "your-app-key",
        "ST_TENANT_ID": "your-tenant-id",
        "ST_ENVIRONMENT": "production"
      }
    }
  }
}

⚠️ ST_ENVIRONMENT defaults to integration. If you're connecting to a live ServiceTitan account, you must set ST_ENVIRONMENT to production or you'll get silent auth failures and empty results.

Install globally

npm install -g @rowvyn/servicetitan-mcp
servicetitan-mcp       # stdio transport (for Claude Desktop)
servicetitan-mcp-sse     # SSE transport (legacy remote)
servicetitan-mcp-http    # Streamable HTTP transport (recommended remote)

From source

npm install
npm run build

Claude Desktop

For a local checkout, point Claude Desktop at the built stdio entrypoint:

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "servicetitan": {
      "command": "node",
      "args": ["/absolute/path/to/servicetitan-mcp/build/index.js"],
      "env": {
        "ST_CLIENT_ID": "your-client-id",
        "ST_CLIENT_SECRET": "your-client-secret",
        "ST_APP_KEY": "your-app-key",
        "ST_TENANT_ID": "your-tenant-id",
        "ST_TIMEZONE": "America/New_York"
      }
    }
  }
}

Works the same way in Cursor, Windsurf, and any other MCP-compatible host.

Generic stdio

ST_CLIENT_ID=your-client-id \
ST_CLIENT_SECRET=your-client-secret \
ST_APP_KEY=your-app-key \
ST_TENANT_ID=your-tenant-id \
ST_TIMEZONE=America/New_York \
node /absolute/path/to/servicetitan-mcp/build/index.js

Remote Deployment (Streamable HTTP)

Deploy to Fly.io or any server, then connect via mcp-remote:

# On the server
ST_CLIENT_ID=... ST_CLIENT_SECRET=... ST_APP_KEY=... ST_TENANT_ID=... \
  ST_MCP_API_KEY=your-secret node build/streamable-http.js
{
  "mcpServers": {
    "servicetitan": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-instance.fly.dev/mcp",
        "--header",
        "x-api-key: YOUR_MCP_API_KEY"
      ]
    }
  }
}

SSE remains available at build/sse.js for backward compatibility, but it is deprecated. Prefer Streamable HTTP at /mcp for new deployments.


Tool Catalog

467 tools registered across 15 domains:

Domain

Tools

Example Tools

dispatch

74

dispatch_jobs_list, dispatch_appointments_get, dispatch_job_types_list

crm

71

crm_customers_list, crm_contacts_get, crm_bookings_create

export

49

export_invoices, export_customers, export_jobs

inventory

37

inventory_purchase_orders_list, inventory_vendors_list, inventory_warehouses_list

marketing

35

marketing_campaigns_list, marketing_calls_v3_list, marketing_reviews

accounting

33

accounting_invoices_list, accounting_payments_list, accounting_gl_accounts_list

pricebook

31

pricebook_services_list, pricebook_materials_list, pricebook_equipment_list

payroll

27

payroll_payrolls_list, payroll_timesheets_job_list, payroll_gross_pay_items_list

settings

23

settings_business_units_list, settings_tag_types_list, settings_user_roles_list

people

22

people_technicians_list, people_employees_list, people_trucks_list

memberships

21

memberships_list, memberships_types_list, memberships_recurring_services_list

scheduling

17

scheduling_teams_list, scheduling_zones_list, scheduling_capacity_calculate

estimates

11

estimates_list, estimates_get, estimates_items_list

intelligence

10

intel_revenue_summary, intel_daily_snapshot, intel_technician_scorecard

reporting

5

reporting_reports_list, reporting_report_categories_list

Total

466

(+ 1 system tool: st_health_check = 467 total)

With ST_READONLY=true (default), all tools are registered but write and delete operations are blocked at execution time with a clear error message (Readonly mode: operation not permitted). Use ST_CONFIRM_WRITES=true to require _confirmed: true on write operations, or confirm: true on delete operations.


Intelligence Tools

The real differentiator. These 10 tools aggregate multiple API calls and report endpoints into operational insights — the kind of answers that would otherwise require custom BI tooling.

Tool

What It Returns

intel_revenue_summary

Dashboard-matched revenue by business unit. Includes completed revenue, non-job revenue, adjustments, collections, and BU productivity rollups.

intel_daily_snapshot

6-metric same-day ops briefing: revenue-to-date, jobs in progress, call outcomes, bookings, open estimates, and upcoming next-day jobs.

intel_technician_scorecard

Per-tech jobs, revenue, avg ticket, productivity, lead gen, membership close rate, and sales from both tech and marketing leads — with team averages.

intel_membership_health

Active memberships, signups, cancellations, renewals, retention rate, invoiced revenue, and conversion by business unit.

intel_estimate_pipeline

Open/sold/dismissed funnel, conversion rate, days-to-close, age buckets, stale opportunities, and tech sales funnel metrics.

intel_campaign_performance

Campaign calls, bookings, conversion rate, total revenue context, and BU lead-gen metrics from Report 176.

intel_csr_performance

CSR booking performance: jobs booked, revenue, avg ticket, top campaigns, job type mix, conversion metrics, and team averages.

intel_labor_cost

Labor cost summary from the Master Pay File: employee hours, gross pay, hourly rates, activity mix, and BU breakdowns.

intel_invoice_tracking

Invoice email tracking: sent vs not-sent counts, send rate, dollar impact, and unsent breakdowns by business unit and technician.

intel_lookup

Cached reference data — technicians, business units, payment types, membership types with IDs and names. 30-minute TTL.

These tools are why this server exists. Raw CRUD tools are table stakes. Intelligence tools turn API data into business decisions.

Revenue Accuracy

intel_revenue_summary uses ServiceTitan's Reporting API to calculate totals. This is the same source ST's own dashboard uses — which means it includes:

  • Completed Revenue — revenue from completed jobs

  • Non-Job Revenue — membership fees, add-ons, and other income not tied to a specific job

  • Adjustment Revenue — credits, adjustments, and corrections

Raw invoice or job endpoint sums will not match the dashboard. Both miss non-job revenue. For dashboard-matching figures, use intel_revenue_summary. For invoice-level detail, use accounting_invoices_list.

Name-Based Filtering

Most intelligence tools accept businessUnitName and technicianName as alternatives to numeric IDs:

# Instead of:
intel_revenue_summary(startDate="2026-01-01", endDate="2026-04-01", businessUnitId=12345)

# Use:
intel_revenue_summary(startDate="2026-01-01", endDate="2026-04-01", businessUnitName="HVAC")

Business unit name matching uses exact → prefix → contains fallback. Technician name matching uses case-insensitive substring search. If no match is found, the tool returns all data with a warning.


Configuration

Copy .env.example to .env and fill in your credentials.

Required

Variable

Description

ST_CLIENT_ID

ServiceTitan OAuth client ID

ST_CLIENT_SECRET

ServiceTitan OAuth client secret

ST_APP_KEY

ServiceTitan app key (ST-App-Key header)

ST_TENANT_ID

ServiceTitan tenant identifier

ST_MCP_API_KEY

API key for remote MCP clients (required for remote HTTP deployment)

Optional

Variable

Default

Description

ST_ENVIRONMENT

integration

ServiceTitan environment: integration or production

ST_READONLY

true

Block write and delete operations at execution time

ST_CONFIRM_WRITES

false

Require _confirmed: true to execute write tools

ST_MAX_RESPONSE_CHARS

100000

Cap tool response size

ST_DOMAINS

(all)

Comma-separated domain allowlist (e.g. crm,dispatch,reporting)

ST_LOG_LEVEL

info

Log level: debug, info, warn, error

ST_TIMEZONE

UTC

IANA timezone for the tenant (e.g. America/New_York) — used for date-bound intelligence queries and local-time display conversion in all tool responses

ST_RESPONSE_SHAPING

true

Set to false to disable intelligence response transformation

ST_CORS_ORIGIN

(none)

Allowed CORS origin for Streamable HTTP / SSE. Required for browser access.

ST_ALLOWED_CALLERS

(none)

Comma-separated caller identity allowlist (e.g. alice@example.com,svc-user)

ST_INTEL_CACHE_TTL_MS

300000

Intelligence result cache TTL in milliseconds (default: 5 minutes)

ST_MCP_PORT / PORT

3100

HTTP server port for Streamable HTTP and SSE transports

ST_MCP_API_KEY

(none)

API key for authenticating remote MCP clients (required for HTTP transports)

Set ST_TIMEZONE to your tenant's local timezone. Without it, date-only queries (e.g. startDate: "2026-02-01") are interpreted as UTC midnight — which can miss or include invoices and jobs near day boundaries for non-UTC tenants, and tool responses will keep timestamps in UTC instead of your local display timezone.

Boolean env vars accept: true, false, 1, 0 (case-insensitive).


Architecture

The server is built as a layered system: Config → OAuth Client → Domain Registry → MCP Server.

  • Domain module pattern — each domain lives in src/domains/<domain>/ and exports a loader that registers its tools

  • Dynamic discovery — src/domains/loader.ts scans src/domains/*/index.ts and imports each domain at runtime

  • Central registry — ToolRegistry handles domain filtering, read-only enforcement, confirmation wrapping, and audit logging

  • OAuth client — ServiceTitanClient manages client-credentials auth, token refresh, retry-on-401/429, and {tenant} path injection

  • Response shaping — transformer layer strips API noise and structures responses for LLM consumption

  • Intelligence layer — composite tools fan out to multiple endpoints and report IDs, then aggregate results

See ARCHITECTURE.md for the full deep-dive: route table, response shaping pipeline, intelligence layer design, and safety system.


CLI Companion

If you prefer working from the terminal directly, servicetitan-cli is a companion st binary built from the same auth and intelligence layer:

# Install
npm install -g @rowvyn/servicetitan-cli

# Same intelligence — no MCP required
st revenue --period ytd --compact
st snapshot --compact

# Pipe into your agent
st customers list --all --json | your-agent process

The CLI and this MCP server share the same design philosophy: push the business question into the tool name, minimize schema overhead, and shape responses for AI consumption.


Comparison

Feature

This Server

Community MCP Servers

Revenue accuracy

✅ Dashboard-matched

❌ $17–21K off per period

Intelligence tools

✅ 10 tools

❌ None

Domain coverage

✅ 467 tools, 15 domains

⚠️ 10–50 tools

Safety layer

✅ Read-only default, audit log

❌ None

Response shaping

✅ LLM-optimized

❌ Raw API responses

Name-based filtering

✅ Resolve names to IDs automatically

❌ Numeric IDs required

Remote deployment

✅ Streamable HTTP + mcp-remote

⚠️ Varies


Development

npm run dev        # tsc --watch
npm run test       # vitest run
npm run lint       # eslint src/
npm run typecheck  # tsc --noEmit
npm run build      # compile to build/
npm run start      # run compiled server

Safety

  • Read-only mode (ST_READONLY=true by default) — all tools are registered but write and delete operations are blocked at execution time

  • Confirmation workflow — delete tools require confirm: true (returns preview payload when missing); write tools optionally require _confirmed: true via ST_CONFIRM_WRITES=true (returns error when missing)

  • Audit logging — all write/delete executions emit [AUDIT] log records with timestamp, tool, operation, resource, and sanitized params (secrets/tokens redacted)


Troubleshooting

npm permission errors (EACCES)

If you see EACCES: permission denied errors when Claude Desktop tries to start the server, your npm cache directory is likely owned by root (common when Node was installed with sudo).

Fix:

sudo chown -R $(whoami) ~/.npm

Then restart Claude Desktop.

Server won't start / "Could not connect to MCP server"

  1. Test outside Claude Desktop first:

    npx -y @rowvyn/servicetitan-mcp

    If this fails, the issue is with Node, npm, or your environment — not Claude Desktop.

  2. Check Node version: node -v — requires Node 22 or newer.

  3. Check for conflicting MCP installs: If you previously installed a different ServiceTitan MCP server, remove it:

    npm ls -g --depth=0 | grep -i servicetitan
    npm uninstall -g <old-package-name>
    npx clear-npx-cache
  4. Verify your claude_desktop_config.json has no leftover entries from a previous MCP server. Only one servicetitan entry should exist under mcpServers.

Auth failures / $0 revenue / empty results

  • Set ST_ENVIRONMENT to production. This is the #1 cause. The default is integration, which authenticates against ServiceTitan's sandbox — not your live account. You'll get valid auth tokens that return zero data.

  • Verify credentials match: ST_CLIENT_ID and ST_CLIENT_SECRET must be from the same ServiceTitan app. You can't mix credentials from different apps.

  • Check ST_TENANT_ID: Must match the tenant associated with your app in the ServiceTitan developer portal.

Claude Desktop logs

Claude Desktop writes MCP server logs to:

  • macOS: ~/Library/Logs/Claude/mcp*.log

  • Windows: %APPDATA%\Claude\logs\mcp*.log


Contributing

See CONTRIBUTING.md.


Security

See SECURITY.md for the vulnerability disclosure policy.


License

MIT

Available Tools

264 tools
accounting_ap_credits_listA
Read-onlyIdempotent

List one requested page of vendor AP credits, filterable by credit IDs and created or modified timestamps. Use this for credits on vendor accounts; use accounting_ap_payments_list for AP disbursements and accounting_payments_list for customer receipts.

Inputs: ids, page, sort, pageSize, +5 more. Returns: object

accounting_ap_payments_listA
Read-onlyIdempotent

List one requested page of vendor AP payments, filterable by payment IDs and created or modified timestamps. Use this for accounts-payable disbursements; use accounting_ap_credits_list for vendor credits and accounting_payments_list for customer receipts.

Inputs: ids, page, sort, pageSize, +5 more. Returns: object

accounting_gl_accounts_getA
Read-onlyIdempotent

Retrieve a GL account by its ServiceTitan ID. Returns the single upstream record without pagination; use accounting_gl_accounts_list to search when the ID is unknown.

Inputs: accountId (required). Returns: object

accounting_gl_accounts_listA
Read-onlyIdempotent

List one requested page of general-ledger accounts, with filters for IDs, names, numbers, types, subtypes, source, description, and Intacct flags. Use accounting_gl_accounts_get for one known account and accounting_gl_account_types_list to resolve account-type metadata.

Inputs: ids, page, sort, names, +14 more. Returns: object

accounting_gl_account_types_listA
Read-onlyIdempotent

List one requested page of GL account-type definitions, filterable by type IDs, names, and active state. Use this catalog to resolve types for GL accounts; use accounting_gl_accounts_list for the actual ledger accounts.

Inputs: ids, page, sort, names, +7 more. Returns: object

accounting_invoices_custom_field_types_listA
Read-onlyIdempotent

List one requested page of invoice custom-field definitions, with paging and total-count controls. Use this to resolve the metadata for invoice custom fields; use accounting_invoices_list to retrieve invoice records and their values.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

accounting_invoices_listA
Read-onlyIdempotent

List one requested page of customer invoice headers using customer, job, business-unit, invoice, date, amount, balance, review, and assignment filters. Use this for filtered invoice search; use estimates or invoice-item tools when the required grain is an estimate or individual line item.

Inputs: ids, page, sort, jobId, +28 more. Returns: object

accounting_journal_entries_get_detailsA
Read-onlyIdempotent

Retrieve journal-entry detail rows for the requested journal-entry IDs. Use this for line-level account and amount detail; use accounting_journal_entries_get_summary for header-level totals.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

accounting_journal_entries_get_summaryA
Read-onlyIdempotent

Retrieve journal-entry summary rows for the requested journal-entry IDs. Use this for header-level accounting totals; use accounting_journal_entries_get_details for the corresponding line-level detail rows.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

accounting_journal_entries_listA
Read-onlyIdempotent

List one requested page of journal-entry headers using IDs, numbers, sync status, posted dates, and created or modified timestamps. Use this to discover entry IDs, then choose accounting_journal_entries_get_summary for summary rows or accounting_journal_entries_get_details for line-level rows.

Inputs: ids, name, page, sort, +26 more. Returns: object

accounting_payments_custom_field_types_listA
Read-onlyIdempotent

List one requested page of payment custom-field definitions, with paging and total-count controls. Use this to resolve payment field metadata; use accounting_payments_list for customer payment transactions and their field values.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

accounting_payments_listA
Read-onlyIdempotent

List one requested page of customer payment transactions using payment or applied-invoice identifiers, customer, business-unit, batch, status, date, and total-amount filters. Use accounting_payment_types_list for payment-method definitions; use accounting_ap_payments_list for vendor disbursements.

Inputs: ids, page, sort, batchId, +19 more. Returns: object

accounting_payment_terms_getA
Read-onlyIdempotent

Retrieve a payment term by its ServiceTitan ID. Returns the single upstream record without pagination; use accounting_payment_terms_list to search when the ID is unknown.

Inputs: paymentTermId (required). Returns: object

accounting_payment_terms_listA
Read-onlyIdempotent

List one requested page of invoice payment-term definitions, filterable by IDs and created or modified timestamps. Use accounting_payment_terms_get for one known term; use accounting_invoices_list for invoice transactions.

Inputs: ids, page, sort, pageSize, +5 more. Returns: object

accounting_payment_types_getA
Read-onlyIdempotent

Retrieve a payment type by its ServiceTitan ID. Returns the single upstream record without pagination; use accounting_payment_types_list to search when the ID is unknown.

Inputs: id (required). Returns: object

accounting_payment_types_listA
Read-onlyIdempotent

List one requested page of customer payment-type definitions, filterable by IDs, active state, and creation timestamps. Use this catalog to interpret or select payment methods; use accounting_payments_list for actual customer payment transactions.

Inputs: ids, page, active, pageSize, +3 more. Returns: object

accounting_tax_zones_listA
Read-onlyIdempotent

List one requested page of tax-zone definitions, filterable by IDs, active state, and created or modified timestamps. Use this catalog to resolve tax treatment identifiers; it does not return invoice transactions or calculated tax totals.

Inputs: ids, page, sort, active, +6 more. Returns: object

crm_booking_provider_tags_getA
Read-onlyIdempotent

Retrieve one booking-provider tag record by ID, including its name and description. Use crm_booking_provider_tags_list to search by name, multiple IDs, or change dates.

Inputs: id (required). Returns: object

crm_booking_provider_tags_listA
Read-onlyIdempotent

Search booking-provider tag definitions by name, IDs, or created and modified ranges. Returns one page; use crm_booking_provider_tags_get when the tag ID is already known.

Inputs: ids, name, page, sort, +6 more. Returns: object

crm_bookings_contacts_listA
Read-onlyIdempotent

List one page of contacts attached to a tenant booking. Supply the booking ID; use page and pageSize to continue through results.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

crm_bookings_getA
Read-onlyIdempotent

Retrieve one tenant booking record by booking ID. Use crm_bookings_list to search when the ID is unknown, or the provider-scoped get when the booking provider must be part of the route.

Inputs: id (required). Returns: object

crm_bookings_listA
Read-onlyIdempotent

Search tenant bookings by IDs, external ID, or created and modified ranges. Returns one page; use crm_bookings_get for a known booking ID.

Inputs: ids, page, sort, pageSize, +6 more. Returns: object

crm_bookings_provider_contacts_listA
Read-onlyIdempotent

List one page of contacts for a booking within a specified booking provider. Requires both provider and booking IDs.

Inputs: id (required), bookingProvider (required), page, pageSize, +1 more. Returns: object

crm_bookings_provider_getA
Read-onlyIdempotent

Retrieve one booking record from a specified booking provider using both provider and booking IDs. Use crm_bookings_get for the tenant-wide ID route, or the provider list when the booking ID is unknown.

Inputs: id (required), bookingProvider (required). Returns: object

crm_bookings_provider_listA
Read-onlyIdempotent

Search one booking provider's bookings by IDs, external ID, or created and modified ranges. Returns one page and requires the provider ID.

Inputs: bookingProvider (required), ids, page, sort, +7 more. Returns: object

crm_contact_methods_getA
Read-onlyIdempotent

Retrieve one contact-method record using its parent contact UUID and contact-method UUID. Use crm_contact_methods_list to search that contact's methods when the method ID is unknown.

Inputs: contactId (required), contactMethodId (required). Returns: object

crm_contact_methods_listA
Read-onlyIdempotent

Search one contact's phone, email, or other contact methods by reference, type, value, or date filters. Returns one page and requires contactId.

Inputs: contactId (required), page, sort, type, +8 more. Returns: object

crm_contact_relationships_listA
Read-onlyIdempotent

List one page of contact-to-entity relationship records for a known contact UUID, optionally filtered by related entity, type slug, type name, or creation time. Use crm_contacts_by_relationship_list for contacts associated with a known relationship ID.

Inputs: contactId (required), page, sort, pageSize, +6 more. Returns: object

crm_contacts_by_relationship_listA
Read-onlyIdempotent

Search contact records associated with a known relationship ID, with optional identity, archive, and date filters. Returns one page; use crm_contact_relationships_list to inspect the links owned by one known contact.

Inputs: relationshipId (required), name, page, sort, +9 more. Returns: object

crm_contacts_getA
Read-onlyIdempotent

Retrieve one CRM contact record by UUID, including its stored identity fields. Use crm_contacts_list to search by name, title, reference ID, archive status, or change dates.

Inputs: id (required). Returns: object

crm_contacts_listA
Read-onlyIdempotent

Search CRM contacts by name, title, reference ID, archive status, or date ranges. Returns one page; use crm_contacts_get for a known UUID.

Inputs: name, page, sort, title, +8 more. Returns: object

crm_customers_contacts_listA
Read-onlyIdempotent

List one page of contacts attached to a known customer. Use crm_customers_contacts_modified_list for cross-customer incremental contact queries.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

crm_customers_contacts_modified_listA
Read-onlyIdempotent

Search contact records across specified customers using created or modified time ranges. Returns one page; use crm_customers_contacts_list for all contacts of one known customer.

Inputs: page, pageSize, customerIds, includeTotal, +4 more. Returns: object

crm_customers_custom_field_types_listA
Read-onlyIdempotent

List one page of custom-field type definitions available to customers, with created and modified date filters. This returns field metadata, not values for one customer.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

crm_customers_getA
Read-onlyIdempotent

Retrieve one customer record by ID, including the customer data returned by ServiceTitan. Use crm_customers_list to search by name, address, phone, external data, activity, or date ranges.

Inputs: id (required). Returns: object

crm_customers_listA
Read-onlyIdempotent

Search customers by IDs, name, address, phone, coordinates, external data, activity, or created and modified ranges. Returns one page; use crm_customers_get for a known ID.

Inputs: ids, zip, city, name, +20 more. Returns: object

crm_customers_notes_listA
Read-onlyIdempotent

List one page of notes attached to a known customer, optionally filtered by created or modified timestamps. Requires the customer ID.

Inputs: id (required), page, pageSize, includeTotal, +4 more. Returns: object

crm_leads_getA
Read-onlyIdempotent

Retrieve one CRM lead record by ID, including its customer and lead details. Use crm_leads_list to search by customer, status, prospect state, location fields, or date ranges.

Inputs: id (required). Returns: object

crm_leads_listA
Read-onlyIdempotent

Search CRM leads by IDs, customer, status, prospect state, customer location, or created and modified ranges. Returns one page; use crm_leads_get for a known ID.

Inputs: ids, page, sort, status, +16 more. Returns: object

crm_leads_notes_listA
Read-onlyIdempotent

List one page of notes attached to a known lead, optionally filtered by created or modified timestamps. Requires the lead ID.

Inputs: id (required), page, pageSize, includeTotal, +4 more. Returns: object

crm_location_labor_types_listA
Read-onlyIdempotent

List one page of labor-type assignment records for specified location IDs, optionally filtered by active state or creation time. Use this to determine which labor types apply across known service locations.

Inputs: page, sort, active, pageSize, +4 more. Returns: object

crm_locations_contacts_listA
Read-onlyIdempotent

List one page of contacts attached to a known service location. Use crm_locations_contacts_modified_list for cross-location incremental contact queries.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

crm_locations_contacts_modified_listA
Read-onlyIdempotent

Search contact records across specified locations using created or modified time ranges. Returns one page; use crm_locations_contacts_list for all contacts of one known location.

Inputs: page, pageSize, locationIds, includeTotal, +4 more. Returns: object

crm_locations_custom_field_types_listA
Read-onlyIdempotent

List one page of custom-field type definitions available to locations, with created and modified date filters. This returns field metadata, not values for one location.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

crm_locations_getA
Read-onlyIdempotent

Retrieve one service-location record by ID, including its customer and address data. Use crm_locations_list to search by customer, address, external data, activity, or date ranges.

Inputs: id (required). Returns: object

crm_locations_listA
Read-onlyIdempotent

Search service locations by IDs, customer, name, address, coordinates, external data, activity, or date ranges. Returns one page; use crm_locations_get for a known ID.

Inputs: ids, zip, city, name, +19 more. Returns: object

crm_locations_notes_listA
Read-onlyIdempotent

List one page of notes attached to a known service location, optionally filtered by created or modified timestamps. Requires the location ID.

Inputs: id (required), page, pageSize, includeTotal, +4 more. Returns: object

dispatch_appointments_getA
Read-onlyIdempotent

Retrieve one appointment record by ID, including its dispatch and scheduling data. Use dispatch_appointments_list to search by job, customer, technician, status, start time, or other filters.

Inputs: id (required). Returns: object

dispatch_appointments_listA
Read-onlyIdempotent

Search appointments by IDs, job, project, customer, technician, status, start range, or created and modified ranges. Returns one page; use dispatch_appointments_get for a known ID.

Inputs: ids, page, sort, jobId, +14 more. Returns: object

dispatch_arrival_window_configuration_getA
Read-onlyIdempotent

Retrieve the tenant-wide arrival-window configuration as one unpaged response. It returns scheduling configuration rather than an individual window; use dispatch_arrival_windows_get or list for window definitions.

Inputs: no named parameters. Returns: object

dispatch_arrival_windows_getA
Read-onlyIdempotent

Retrieve one arrival-window definition by ID, including its time span and applicable business units. Use dispatch_arrival_windows_list to browse by active state or creation time.

Inputs: id (required). Returns: object

dispatch_arrival_windows_listA
Read-onlyIdempotent

List one page of arrival-window definitions, optionally filtered by active state or creation time. Each record supplies a configured window and applicable business units; use dispatch_arrival_windows_get for a known ID.

Inputs: page, active, pageSize, includeTotal, +2 more. Returns: object

dispatch_call_reasons_listA
Read-onlyIdempotent

List one page of dispatch call-reason catalog entries, filtered by active state or created and modified ranges. Use these IDs when a workflow requires a call reason.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

dispatch_forms_listA
Read-onlyIdempotent

Search dispatch form definitions by IDs, name, publication status, active state, conditional logic, triggers, and date ranges. Returns one page of form metadata; use dispatch_form_submissions_list for completed or pending submissions.

Inputs: ids, name, page, sort, +10 more. Returns: object

dispatch_form_submissions_listA
Read-onlyIdempotent

Search submitted form records by form, creator, status, owner expression, submitted range, or active state. Returns one page; use this for submission results rather than form definitions.

Inputs: page, sort, active, owners, +8 more. Returns: object

dispatch_images_getA
Read-onlyIdempotent

Request image response data for a ServiceTitan storage path. The upstream Pricebook image operation documents an HTTP 302 redirect; this wrapper returns the client-decoded response body through its standard JSON/text envelope, without exposing the redirect Location header. Supply the known path when targeting an image; use dispatch_jobs_list_attachments to discover job attachments.

Inputs: path. Returns: object

dispatch_installed_equipment_attachments_getA
Read-onlyIdempotent

Request an installed-equipment attachment by its ServiceTitan storage path. Returns the client-decoded attachment response; the pinned API does not define a response-body schema. Supply the exact known path; use dispatch_installed_equipment_get for the equipment record itself.

Inputs: path. Returns: object

dispatch_installed_equipment_getA
Read-onlyIdempotent

Retrieve one installed-equipment record by ID, including its location and equipment details. Use dispatch_installed_equipment_list to search by location, IDs, active state, or date ranges.

Inputs: id (required). Returns: object

dispatch_installed_equipment_listA
Read-onlyIdempotent

Search installed-equipment records by IDs, location IDs, active state, or created and modified ranges. Returns one page; use dispatch_installed_equipment_get for a known ID.

Inputs: ids, page, sort, active, +7 more. Returns: object

dispatch_job_cancel_reasons_listA
Read-onlyIdempotent

Browse the paginated job-cancellation-reason catalog using active and date filters. Use dispatch_jobs_cancel_reasons_list instead only to look up a supplied set of known reason IDs.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

dispatch_job_hold_reasons_listA
Read-onlyIdempotent

List one page of job-hold-reason catalog entries, filtered by active state or created and modified ranges. Returned records provide reason IDs and metadata used when placing a job on hold; they are distinct from cancellation reasons.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

dispatch_jobs_booked_log_getA
Read-onlyIdempotent

Retrieve booking-log details for a known job ID as one unpaged audit resource. Use dispatch_jobs_get for the current job record rather than its booking audit data.

Inputs: id (required). Returns: object

dispatch_jobs_canceled_logs_listA
Read-onlyIdempotent

List one page of cancellation log entries for a known job ID. Use this for cancellation audit details rather than the current job or cancellation-reason catalog.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

dispatch_jobs_cancel_reasons_listA
Read-onlyIdempotent

Look up job cancellation reasons for a supplied list of known IDs. This non-paginated Jobs endpoint is distinct from dispatch_job_cancel_reasons_list, which browses and filters the reason catalog.

Inputs: ids. Returns: object

dispatch_jobs_custom_field_types_listA
Read-onlyIdempotent

List one page of custom-field type definitions available to jobs, with created and modified date filters. This returns field metadata, not values for one job.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

dispatch_jobs_equipment_getA
Read-onlyIdempotent

Retrieve the installed-equipment ID collection attached to a known job as one unpaged response. Use dispatch_installed_equipment_get or list to fetch the equipment records themselves.

Inputs: id (required). Returns: object

dispatch_jobs_getA
Read-onlyIdempotent

Retrieve one job record by ID, optionally scoped to an external-data application. Returns the current ServiceTitan job data; use dispatch_jobs_list to search by customer, location, status, dates, or other filters.

Inputs: id (required), externalDataApplicationGuid. Returns: object

dispatch_jobs_get_attachmentA
Read-onlyIdempotent

Retrieve one job-attachment resource from Forms v2 by attachment ID. Use dispatch_jobs_list_attachments to browse attachment metadata for a known job when the attachment ID is unknown.

Inputs: id (required). Returns: object

dispatch_jobs_history_getA
Read-onlyIdempotent

Retrieve the history response for a known job ID as one unpaged audit resource. Use dispatch_jobs_get for the current job record rather than its historical changes.

Inputs: id (required). Returns: object

dispatch_jobs_listA
Read-onlyIdempotent

Search jobs by IDs, number, customer, location, project, status, appointments, equipment, tags, dates, or other supported filters. Returns one page; use dispatch_jobs_get for a known job ID.

Inputs: ids, page, sort, number, +31 more. Returns: object

dispatch_jobs_list_attachmentsA
Read-onlyIdempotent

List one page of attachments for a known job, optionally filtered by creation time and sorted. Returned records identify files attached to that job.

Inputs: jobId (required), page, sort, pageSize, +3 more. Returns: object

dispatch_jobs_notes_listA
Read-onlyIdempotent

List one page of notes attached to a known job. Requires the job ID; this endpoint has pagination controls but no note-content filters.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

dispatch_job_splits_by_jobs_listA
Read-onlyIdempotent

Search one page of job-split records across supplied job IDs, with activity and date filters. Use dispatch_job_splits_list when working with one job-scoped route.

Inputs: page, sort, active, jobIds, +6 more. Returns: object

dispatch_job_splits_listA
Read-onlyIdempotent

List one page of split records for a single required job ID, with activity and date filters. Use dispatch_job_splits_by_jobs_list to query splits across multiple jobs.

Inputs: jobId (required), page, sort, active, +6 more. Returns: object

dispatch_job_types_getA
Read-onlyIdempotent

Retrieve one job-type definition by ID, optionally scoped to an external-data application. Returns the configured defaults and associations for that type; use dispatch_job_types_list to search the catalog.

Inputs: id (required), externalDataApplicationGuid. Returns: object

dispatch_job_types_listA
Read-onlyIdempotent

Search job-type definitions by IDs, name, priority, duration, active state, external-data application, or date ranges. Returns one page of configured job types; use dispatch_job_types_get for a known ID.

Inputs: ids, name, page, active, +12 more. Returns: object

dispatch_projects_custom_field_types_listA
Read-onlyIdempotent

List one page of custom-field type definitions available to projects, with created and modified date filters. This returns field metadata, not values for one project.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

dispatch_projects_getA
Read-onlyIdempotent

Retrieve one project record by ID, optionally scoped to an external-data application. Returns the current project data; use dispatch_projects_list to search by customer, location, status, dates, or linked work.

Inputs: id (required), externalDataApplicationGuid. Returns: object

dispatch_projects_listA
Read-onlyIdempotent

Search projects by IDs, customer, location, status, type, manager, dates, or linked jobs, appointments, and invoices. Returns one page; use dispatch_projects_get for a known ID.

Inputs: ids, page, sort, jobId, +24 more. Returns: object

dispatch_projects_notes_listA
Read-onlyIdempotent

List one page of notes attached to a known project. Requires the project ID; use dispatch_projects_get for the project record itself.

Inputs: id (required), page, pageSize, includeTotal. Returns: object

dispatch_project_statuses_getA
Read-onlyIdempotent

Retrieve one project-status definition by ID, including its configured status metadata. Use dispatch_project_statuses_list to search the catalog and the sub-status list for finer classifications.

Inputs: id (required). Returns: object

dispatch_project_statuses_listA
Read-onlyIdempotent

Search one page of project-status definitions by IDs, name, or created and modified ranges. Use the returned status IDs to classify projects, and dispatch_project_sub_statuses_list to find their finer-grained sub-statuses.

Inputs: ids, name, page, sort, +6 more. Returns: object

dispatch_project_sub_statuses_getA
Read-onlyIdempotent

Retrieve one project sub-status definition by ID, including its parent-status metadata. Use dispatch_project_sub_statuses_list to search by parent status, name, IDs, active state, or dates.

Inputs: id (required). Returns: object

dispatch_project_sub_statuses_listA
Read-onlyIdempotent

Search one page of project sub-status definitions by parent status, IDs, name, active state, or date ranges. Returned records refine a project's status; use dispatch_project_statuses_list for the parent status catalog.

Inputs: ids, name, page, sort, +8 more. Returns: object

dispatch_project_types_getA
Read-onlyIdempotent

Retrieve one project-type definition by ID, including its configured type metadata. Use dispatch_project_types_list to browse the paginated type catalog when the ID is unknown.

Inputs: id (required). Returns: object

dispatch_project_types_listA
Read-onlyIdempotent

List one page of project-type definitions. Use dispatch_project_types_get when a project-type ID is already known.

Inputs: page, pageSize, includeTotal. Returns: object

estimates_estimate_templates_getA
Read-onlyIdempotent

Retrieve an estimate template by its ServiceTitan ID. Returns the single upstream record without pagination; use estimates_estimate_templates_list to search when the ID is unknown.

Inputs: id (required). Returns: object

estimates_estimate_templates_listA
Read-onlyIdempotent

List one requested page of estimate templates, filterable by active state and modified timestamps. Use estimates_estimate_templates_get for a known template ID; use estimates_list for customer estimates created from templates.

Inputs: page, active, pageSize, includeTotal, +2 more. Returns: object

estimates_export_estimatesA
Read-onlyIdempotent

Read the incremental estimate export feed for synchronization. Supply from as the change-window start and continue with the response continuation token when present; use estimates_list for interactive filtered browsing and estimates_get for a known ID.

Inputs: from, includeRecentChanges. Returns: object

estimates_getA
Read-onlyIdempotent

Retrieve a single estimate by its ServiceTitan ID. Returns the single upstream record without pagination; use estimates_list to search when the ID is unknown.

Inputs: id (required). Returns: object

estimates_items_listA
Read-onlyIdempotent

Search one requested page of estimate line items by estimate ID, item IDs, active state, or creation and modification dates. Each result represents an item attached to an estimate, rather than an estimate header returned by estimates_list.

Inputs: ids, page, active, pageSize, +6 more. Returns: object

estimates_listA
Read-onlyIdempotent

Search one requested page of estimates by job, project, location, status, dates, salesperson, or total amount. Use estimates_get for one known estimate; use estimates_export_estimates for incremental synchronization.

Inputs: ids, page, sort, jobId, +19 more. Returns: object

estimates_proposal_templates_getA
Read-onlyIdempotent

Retrieve a proposal template by its ServiceTitan ID. Returns the single upstream record without pagination; use estimates_proposal_templates_list to search when the ID is unknown.

Inputs: id (required). Returns: object

estimates_proposal_templates_listA
Read-onlyIdempotent

List one requested page of proposal templates, filterable by active state, modified timestamps, and proposal type ID. Use estimates_proposal_templates_get for a known template and estimates_proposal_types_list to resolve the type filter.

Inputs: page, active, pageSize, includeTotal, +3 more. Returns: object

estimates_proposal_types_listA
Read-onlyIdempotent

List proposal-type definitions available for grouping and filtering proposal templates. Use estimates_proposal_templates_list to retrieve the templates that reference these types.

Inputs: active. Returns: object

export_activitiesA
Read-onlyIdempotent

Read the incremental timesheet-activity export feed for cross-domain bulk synchronization. This is the same feed as settings_activities_export; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

export_activity_codesA
Read-onlyIdempotent

Read the incremental activity-code export feed for cross-domain bulk synchronization. This is the same feed as settings_activity_codes_export; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

export_adjustmentsA
Read-onlyIdempotent

Read the incremental adjustments export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_appointment_assignmentsA
Read-onlyIdempotent

Read the incremental appointment assignments export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_appointmentsA
Read-onlyIdempotent

Read the incremental appointments export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_bookingsA
Read-onlyIdempotent

Read the incremental bookings export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_business_unitsA
Read-onlyIdempotent

Read the incremental business units export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_callsA
Read-onlyIdempotent

Read the incremental calls export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_customersA
Read-onlyIdempotent

Read the incremental customers export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_customers_contactsA
Read-onlyIdempotent

Read the incremental customers contacts export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_employeesA
Read-onlyIdempotent

Read the incremental employee export feed for cross-domain bulk synchronization. This is the same feed as people_employees_export; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

export_equipmentA
Read-onlyIdempotent

Read the incremental equipment export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_gross_pay_itemsA
Read-onlyIdempotent

Read the incremental gross pay items export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_installed_equipmentA
Read-onlyIdempotent

Read the incremental installed equipment export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_inventory_billsA
Read-onlyIdempotent

Read the incremental inventory bills export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_invoice_itemsA
Read-onlyIdempotent

Read the incremental invoice items export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_invoicesA
Read-onlyIdempotent

Read the incremental invoices export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_invoice_templatesA
Read-onlyIdempotent

Read the incremental invoice templates export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_job_canceled_logsA
Read-onlyIdempotent

Read the incremental job canceled logs export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_job_historyA
Read-onlyIdempotent

Read the incremental job history export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_job_notesA
Read-onlyIdempotent

Read the incremental job notes export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_jobsA
Read-onlyIdempotent

Read the incremental jobs export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_job_splitsA
Read-onlyIdempotent

Read the incremental job splits export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_leadsA
Read-onlyIdempotent

Read the incremental leads export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_locationsA
Read-onlyIdempotent

Read the incremental locations export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_locations_contactsA
Read-onlyIdempotent

Read the incremental locations contacts export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_materialsA
Read-onlyIdempotent

Read the incremental materials export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_membershipsA
Read-onlyIdempotent

Read the incremental memberships export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_membership_status_changesA
Read-onlyIdempotent

Read the incremental membership status changes export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_membership_typesA
Read-onlyIdempotent

Read the incremental membership types export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_paymentsA
Read-onlyIdempotent

Read the incremental payments export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_payroll_adjustmentsA
Read-onlyIdempotent

Read the incremental payroll adjustments export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_payroll_settingsA
Read-onlyIdempotent

Read the incremental payroll settings export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_project_notesA
Read-onlyIdempotent

Read the incremental project notes export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_projectsA
Read-onlyIdempotent

Read the incremental projects export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_purchase_ordersA
Read-onlyIdempotent

Read the incremental purchase orders export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_recurring_service_typesA
Read-onlyIdempotent

Read the incremental recurring service types export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_returnsA
Read-onlyIdempotent

Read the incremental returns export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_service_agreementsA
Read-onlyIdempotent

Read the incremental service agreements export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_servicesA
Read-onlyIdempotent

Read the incremental services export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_tag_typesA
Read-onlyIdempotent

Read the incremental tag-type export feed for cross-domain bulk synchronization. This is the same feed as settings_tag_types_export; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

export_techniciansA
Read-onlyIdempotent

Read the incremental technicians export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_timesheet_codesA
Read-onlyIdempotent

Read the incremental timesheet codes export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

export_transfersA
Read-onlyIdempotent

Read the incremental transfers export feed for bulk synchronization. Start with a date or omit from to start at the beginning of the feed, continue immediately with continueFrom while hasMore is true, and when false retain it and wait before polling again. includeRecentChanges may return records sooner but can repeat them.

Inputs: from, includeRecentChanges. Returns: object

intel_campaign_performanceA
Read-onlyIdempotent

Compare marketing campaigns over the selected date range by combining all fetched call, booking, job, and invoice pages. Returns calls, bookings, booked-call conversion, attributed revenue, and revenue per call; campaignId narrows the analysis to one known campaign. The metrics reflect the wrapper's cross-source attribution logic, and partial source failures are returned in _warnings.

Examples:

  • "Which marketing campaigns are working?" -> startDate="2026-01-01", endDate="2026-03-10"

  • "How many calls are we getting from Google Ads?" -> startDate="2026-01-01", endDate="2026-03-10", campaignId=

  • "What's our call-to-booking rate?" -> startDate="2026-01-01", endDate="2026-03-10"

Inputs: endDate (required), startDate (required), limit, campaignId. Returns: object

intel_csr_performanceA
Read-onlyIdempotent

Summarize CSR-attributed jobs from Report 162 for the selected date range. Returns booked-job counts, revenue, average ticket, campaign and job-type mixes, rankings, and team averages; an optional business-unit name narrows matching report rows. Report execution is cached briefly and may wait for per-report/client spacing; unavailable source data is identified in _warnings.

Examples:

  • "How are our CSRs performing this month?" -> startDate="2026-03-01", endDate="2026-04-01"

  • "Show CSR booking revenue for last quarter" -> startDate="2025-10-01", endDate="2026-01-01"

  • "Which CSR is booking the most revenue for plumbing?" -> startDate="2026-01-01", endDate="2026-03-10", businessUnitName="Plumbing"

Inputs: endDate (required), startDate (required), businessUnitId, businessUnitName. Returns: object

intel_daily_snapshotA
Read-onlyIdempotent

Build a one-day operational snapshot in the configured tenant timezone from all fetched appointment, job, invoice, payment, estimate, and call pages plus Report 163 for the next day. Returns appointment progress, daily invoiced revenue and collections, sold-estimate value, call outcomes, highlights, and at most 20 upcoming jobs; truncation and partial source failures appear in _warnings. Results are cached for 60 seconds.

Examples:

  • "How did today go?" -> date="2026-03-10"

  • "Give me yesterday's numbers" -> date="2026-03-09"

  • "What happened on Monday?" -> date="2026-03-09"

Inputs: date. Returns: object

intel_estimate_pipelineA
Read-onlyIdempotent

Analyze all fetched estimate pages as an open, sold, and dismissed pipeline, with value, conversion, close speed, age buckets, and open estimates older than 30 days. startDate and endDate bound estimate creation timestamps; when both are supplied, Report 172 adds technician sales metrics. soldById filters both sources. Partial source failures are returned in _warnings.

Examples:

  • "What's our close rate on estimates?" -> startDate="2026-01-01", endDate="2026-03-10"

  • "Show me stale estimates over 30 days" -> returns staleEstimates automatically

  • "How is Andrew doing on sales?" -> soldById=<Andrew's ID>

Inputs: endDate, soldById, startDate. Returns: object

intel_invoice_trackingA
Read-onlyIdempotent

Track invoice email delivery for the selected date range by combining and deduplicating Reports 2281 and 2282. Returns sent and not-sent counts, send rate, invoice amount and balance impact, and unsent breakdowns by business unit and technician; an optional business-unit filter applies to both reports. Report calls may wait for per-report/client spacing, and partial source failures are returned in _warnings.

Examples:

  • "What percent of invoices were sent this week?" -> startDate="2026-03-02", endDate="2026-03-09"

  • "Which techs are not sending invoices?" -> startDate="2026-01-01", endDate="2026-03-10"

  • "Show invoice send rate for plumbing last month" -> startDate="2026-02-01", endDate="2026-03-01", businessUnitName="Plumbing"

Inputs: endDate (required), startDate (required), businessUnitId, businessUnitName. Returns: object

intel_labor_costA
Read-onlyIdempotent

Summarize employee regular, overtime, double-overtime, and total hours from Report 166 for the selected date range. When the tenant report exposes GrossPay, the tool also derives cost and effective hourly rate; otherwise those fields are unavailable rather than estimated. Report execution may wait for per-report/client spacing, and source failures are returned in _warnings.

Examples:

  • "What labor hours were reported this month?" -> startDate="2026-03-01", endDate="2026-04-01"

  • "Show overtime hours by employee for Q1" -> startDate="2026-01-01", endDate="2026-04-01"

Inputs: endDate (required), startDate (required), technicianId, businessUnitId, +2 more. Returns: object

intel_lookupA
Read-onlyIdempotent

Look up technicians, business units, payment types, or membership types for use in intelligence-tool filters. Returns matching IDs and names from a 30-minute in-process cache; search performs a case-insensitive name match, while omission returns the available cached set.

Examples:

  • "What are our business units?" -> type="business-units"

  • "Find technician named John" -> type="technicians", search="John"

  • "List all payment types" -> type="payment-types"

  • "What membership types do we have?" -> type="membership-types"

Inputs: type (required), search. Returns: object

intel_membership_healthA
Read-onlyIdempotent

Summarize membership activity from Report 182 and business-unit membership opportunities and conversions from Report 178 for the selected date range. Returns active-at-end counts, sales, cancellations, expirations, renewals, other status movements, and conversion metrics; it does not calculate a cohort retention rate. includeServiceRevenue adds tenant-wide invoice service revenue for the period, which is not membership-attributed. Partial source failures are returned in _warnings.

Examples:

  • "How are memberships doing this year?" -> startDate="2026-01-01", endDate="2026-03-10"

  • "Show membership status movements last quarter" -> startDate="2025-10-01", endDate="2026-01-01"

  • "How many new signups vs cancellations?" -> startDate="2026-01-01", endDate="2026-03-10"

Inputs: endDate (required), startDate (required), includeServiceRevenue. Returns: object

intel_revenue_summaryA
Read-onlyIdempotent

Summarize Report 175 revenue and Report 179 sales for the selected date range, optionally filtered to one business unit. Returns completed, non-job, adjustment, and total revenue plus opportunities, conversion, and sales metrics by business unit; the aggregate reflects returned report rows and is not certified as an all-company total or as matching every tenant dashboard configuration. includeProductivityMetrics adds Report 177 metrics, and includeCollections fetches all payment pages for the period. Report calls are cached briefly and serialized per report/client with at least 65 seconds between starts; a failed source is identified in _warnings and its affected metrics may be empty.

Examples:

  • "What was our total revenue last month?" -> startDate="2026-02-01", endDate="2026-03-01"

  • "How much did HVAC bring in this quarter?" -> startDate="2026-01-01", endDate="2026-04-01", businessUnitName="HVAC"

  • "Revenue year to date" -> startDate="2026-01-01", endDate="2026-03-10"

Inputs: endDate (required), startDate (required), businessUnitId, businessUnitName, +2 more. Returns: object

intel_technician_scorecardA
Read-onlyIdempotent

Build a technician scorecard for the selected date range from ServiceTitan technician reports. Returns revenue, converted jobs, opportunities, conversion, productivity, recalls, upsells, and lead-generation metrics; includeExtendedMetrics adds membership and tech/marketing-lead sales reports. Filter by technician or business unit when comparing a subset, and use limit to bound ranked results. Report calls may wait for per-report/client spacing, and partial source failures are returned in _warnings.

Examples:

  • "How are our techs performing this month?" -> startDate="2026-03-01", endDate="2026-04-01"

  • "Show me Andrew's numbers for Q1" -> startDate="2026-01-01", endDate="2026-04-01", technicianName="Andrew"

  • "Who is our top performer this year?" -> startDate="2026-01-01", endDate="2026-03-10"

Inputs: endDate (required), startDate (required), limit, technicianId, +4 more. Returns: object

inventory_purchase_order_markups_getA
Read-onlyIdempotent

Retrieve a purchase order markup by its ServiceTitan ID. Returns the single upstream record without pagination; use inventory_purchase_order_markups_list to search when the ID is unknown.

Inputs: id (required). Returns: object

inventory_purchase_order_markups_listA
Read-onlyIdempotent

List one requested page of purchase-order markup definitions, filterable by IDs and created or modified timestamps. Use inventory_purchase_order_markups_get for one known markup ID; use inventory_purchase_orders_list for purchase-order transactions.

Inputs: ids, page, sort, pageSize, +5 more. Returns: object

inventory_purchase_orders_getA
Read-onlyIdempotent

Retrieve a purchase order by its ServiceTitan ID. Returns the single upstream record without pagination; use inventory_purchase_orders_list to search when the ID is unknown.

Inputs: id (required). Returns: object

inventory_purchase_orders_listA
Read-onlyIdempotent

List one requested page of issued purchase orders using IDs, number, status, technician, job, project, and order or sent-date filters. Use inventory_purchase_orders_get for one known order and inventory_purchase_orders_requests_list for requests that precede issued orders.

Inputs: ids, page, sort, jobId, +15 more. Returns: object

inventory_purchase_orders_requests_listA
Read-onlyIdempotent

Search purchase-order requests with the exposed identifiers, status, date, technician, job, and paging filters. These are requests that may precede a purchase order; use inventory_purchase_orders_list for issued purchase orders.

Inputs: ids, page, sort, jobId, +13 more. Returns: object

inventory_purchase_order_types_listA
Read-onlyIdempotent

List one requested page of purchase-order type definitions, with active-state and created or modified timestamp filters. Use this catalog to interpret order classifications; use inventory_purchase_orders_list for issued purchase-order records.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

inventory_receipts_listA
Read-onlyIdempotent

List one requested page of inventory receipt transactions using IDs, number, vendor, purchase order, bill, business unit, inventory location, sync status, and received-date filters. Use inventory_purchase_orders_list for originating orders and inventory_returns_list for outbound vendor returns.

Inputs: ids, page, sort, active, +19 more. Returns: object

inventory_returns_listA
Read-onlyIdempotent

List one requested page of inventory return transactions using IDs, number, vendor, job, inventory location, sync status, return dates, and external-data filters. Use inventory_return_types_list for the separate return-type catalog; use inventory_transfers_list for movement between inventory locations.

Inputs: ids, page, sort, jobId, +22 more. Returns: object

inventory_return_types_listA
Read-onlyIdempotent

List one requested page of inventory return-type definitions, with active-state and created or modified timestamp filters. Use this catalog to interpret return classifications; use inventory_returns_list for actual return transactions.

Inputs: name, page, sort, pageSize, +6 more. Returns: object

inventory_transfers_listA
Read-onlyIdempotent

List one requested page of inventory transfers using IDs, number, status, transfer type, source and destination locations, dates, sync status, and external-data filters. Use this for stock moved between locations; use inventory_returns_list for stock returned to a vendor.

Inputs: ids, page, sort, number, +20 more. Returns: object

inventory_vendors_getA
Read-onlyIdempotent

Retrieve a vendor by its ServiceTitan ID. Returns the single upstream record without pagination; use inventory_vendors_list to search when the ID is unknown.

Inputs: id (required), externalDataKey, externalDataValues, externalDataApplicationGuid. Returns: object

inventory_vendors_listA
Read-onlyIdempotent

List one requested page of inventory vendors using IDs, active state, created or modified timestamps, and external-data mapping filters. Use inventory_vendors_get for one known vendor; use inventory_purchase_orders_list for purchase-order records.

Inputs: ids, page, sort, active, +9 more. Returns: object

inventory_warehouses_listA
Read-onlyIdempotent

List one requested page of warehouse definitions using IDs, active state, created or modified dates, and external-data mapping filters. Use this to resolve warehouse and inventory-location identifiers; use inventory transfers or purchase orders for stock movement and procurement.

Inputs: ids, page, sort, active, +9 more. Returns: object

marketing_attributed_leads_getA
Read-onlyIdempotent

Search attributed leads within a required UTC time window, optionally filtered by lead type. Returns one page of leads linked to marketing attribution activity.

Inputs: toUtc (required), fromUtc (required), page, leadType, +2 more. Returns: object

marketing_calls_getA
Read-onlyIdempotent

Retrieve one Marketing Calls v2 call record by numeric ID, including the call details returned by ServiceTitan. Use a call-list tool when the ID is unknown, and the recording or voicemail tools for those media resources.

Inputs: id (required). Returns: object

marketing_calls_recording_getA
Read-onlyIdempotent

Request the audio recording for a known Marketing Calls v2 call ID. ServiceTitan documents an audio/mpeg stream, but this wrapper delivers client-decoded data through its standard JSON/text envelope; use a binary-capable API client when faithful audio bytes are required. Use marketing_calls_get for the call record itself.

Inputs: id (required). Returns: object

marketing_calls_v2_listA
Read-onlyIdempotent

Search calls through Marketing Calls v2 using its activeOnly flag, explicit orderBy and direction, numeric ID array, agents, campaign, duration, phone, or timestamps. Returns one page; prefer v3 unless these v2-specific filter or sorting semantics are required.

Inputs: ids, page, agentId, orderBy, +16 more. Returns: object

marketing_calls_v3_listA
Read-onlyIdempotent

Search calls through Marketing Calls v3 using comma-delimited IDs, caller number, active state, agents, campaign, duration, timestamps, or sort. Returns one page; prefer this for ordinary call search, and use v2 only for its numeric ID array, activeOnly, or orderBy contract.

Inputs: ids, page, sort, active, +16 more. Returns: object

marketing_calls_voice_mail_getA
Read-onlyIdempotent

Request the voicemail audio for a known Marketing Calls v2 call ID. ServiceTitan documents an audio/mpeg stream, but this wrapper delivers client-decoded data through its standard JSON/text envelope; use a binary-capable API client when faithful audio bytes are required. Use marketing_calls_get for the call record itself.

Inputs: id (required). Returns: object

marketing_campaign_costs_getA
Read-onlyIdempotent

Retrieve one campaign-cost record by cost ID. Use marketing_campaign_costs_list to search when the cost ID is unknown.

Inputs: id (required). Returns: object

marketing_campaign_costs_listA
Read-onlyIdempotent

Search campaign costs across campaigns by campaign ID, year, or month. Returns one page; use marketing_campaigns_costs_list when a specific campaign ID is the required path scope.

Inputs: page, sort, year, month, +3 more. Returns: object

marketing_campaigns_costs_listA
Read-onlyIdempotent

List one page of costs for a required campaign ID, optionally filtered by year or month. Use marketing_campaign_costs_list for a broader cost search across campaigns.

Inputs: id (required), page, sort, year, +3 more. Returns: object

marketing_campaigns_getA
Read-onlyIdempotent

Retrieve one marketing campaign record by ID, including its configured campaign data. Use marketing_campaigns_list to search by name, phone number, active state, IDs, or date ranges.

Inputs: id (required). Returns: object

marketing_campaigns_listA
Read-onlyIdempotent

Search campaigns by IDs, name, phone number, active state, or created and modified ranges. Returns one page; use marketing_campaigns_get for a known campaign ID.

Inputs: ids, name, page, sort, +8 more. Returns: object

marketing_client_side_data_getA
Read-onlyIdempotent

Retrieve tenant task reference data: employees, business units, priorities, statuses, types, sources, and resolutions. This Task Management client-side-data operation returns one unpaged response with no inputs; use it to populate task filters or forms, not for marketing analytics.

Inputs: no named parameters. Returns: object

marketing_client_specific_pricing_get_all_rate_sheetsA
Read-onlyIdempotent

Search client-specific pricing rate sheets by IDs, search term, or active state. Returns one page of pricing definitions; despite the legacy name, pagination still applies. Use the rate-sheet ID from this result when updating a sheet.

Inputs: ids, page, active, pageSize, +2 more. Returns: object

marketing_opt_in_outs_listA
Read-onlyIdempotent

Retrieve the tenant's marketing phone opt-out records from the v3 opt-in/out endpoint. This operation accepts no filters or pagination inputs.

Inputs: no named parameters. Returns: object

marketing_reviewsA
Read-onlyIdempotent

Search customer review records by text, rating, source, response type, review status, location, technician, campaign, and date ranges. Returns one page; use inclusion flags when reviews missing those associations must remain in the result.

Inputs: page, sort, search, toDate, +19 more. Returns: object

marketing_scheduler_scheduler_performanceA
Read-onlyIdempotent

Retrieve one scheduler's performance metrics over a required session-created time window. Returns the scheduler performance response for that exact ID and period; use marketing_scheduler_schedulersessions for individual sessions.

Inputs: id (required), sessionCreatedBefore (required), sessionCreatedOnOrAfter (required). Returns: object

marketing_scheduler_schedulersA
Read-onlyIdempotent

List one page of marketing scheduler records, optionally filtered by created or modified timestamps. Use marketing_scheduler_scheduler_performance for metrics about one known scheduler.

Inputs: page, pageSize, includeTotal, createdBefore, +3 more. Returns: object

marketing_scheduler_schedulersessionsA
Read-onlyIdempotent

List one page of sessions for a known scheduler, optionally filtered by created or modified timestamps. Use scheduler performance when aggregated metrics are needed.

Inputs: id (required), page, pageSize, includeTotal, +4 more. Returns: object

memberships_custom_fields_listA
Read-onlyIdempotent

List one requested page of membership custom-field definitions using created and modified timestamp filters. Use this for field metadata; use memberships_list for customer membership records and their field values.

Inputs: page, sort, pageSize, includeTotal, +4 more. Returns: object

memberships_getA
Read-onlyIdempotent

Retrieve a single customer membership by its ServiceTitan ID. Returns the single upstream record without pagination; use memberships_list to search when the ID is unknown.

Inputs: id (required). Returns: object

memberships_listA
Read-onlyIdempotent

List one requested page of customer membership records using membership and customer IDs, status, active state, billing frequency, duration, and created or modified timestamps. Use memberships_get for one known sold membership and memberships_types_list for reusable membership-plan definitions.

Inputs: ids, page, active, status, +9 more. Returns: object

memberships_recurring_service_events_listA
Read-onlyIdempotent

List one requested page of recurring-service events using event IDs, status, job, location, and created or modified timestamp filters. Use memberships_recurring_services_get for the parent service record; use job tools for a job referenced by an event.

Inputs: ids, page, jobId, status, +7 more. Returns: object

memberships_recurring_services_getA
Read-onlyIdempotent

Retrieve a recurring service by its ServiceTitan ID. Returns the single upstream record without pagination; use memberships_recurring_services_list to search when the ID is unknown.

Inputs: id (required). Returns: object

memberships_recurring_services_listA
Read-onlyIdempotent

List one requested page of customer-location recurring services using service, membership, and location IDs, active state, and created or modified timestamps. Use memberships_recurring_services_get for one known service and memberships_types_recurring_service_items_list for plan-level service configuration.

Inputs: ids, page, active, pageSize, +7 more. Returns: object

memberships_recurring_service_types_getA
Read-onlyIdempotent

Retrieve a recurring service type by its ServiceTitan ID. Returns the single upstream record without pagination; use memberships_recurring_service_types_list to search when the ID is unknown.

Inputs: id (required). Returns: object

memberships_recurring_service_types_listA
Read-onlyIdempotent

List one requested page of recurring-service type definitions using IDs, membership type, recurrence type, duration type, active state, and created or modified timestamps. Use memberships_recurring_service_types_get for one known type and memberships_recurring_services_list for customer-location service instances.

Inputs: ids, page, sort, active, +9 more. Returns: object

memberships_service_agreements_getA
Read-onlyIdempotent

Retrieve a service agreement by its ServiceTitan ID. Returns the single upstream record without pagination; use memberships_service_agreements_list to search when the ID is unknown.

Inputs: id (required). Returns: object

memberships_service_agreements_listA
Read-onlyIdempotent

List one requested page of customer service agreements using agreement, customer, business-unit, status, and created or modified timestamp filters. Use memberships_service_agreements_get for a known agreement; use memberships_list for customer membership sales rather than agreement records.

Inputs: ids, page, sort, status, +8 more. Returns: object

memberships_status_changes_listA
Read-onlyIdempotent

Retrieve the status-change history attached to one required customer membership ID. Use memberships_get for the current membership record or memberships_list when the membership ID must be discovered first.

Inputs: id (required). Returns: object

memberships_types_discounts_listA
Read-onlyIdempotent

Retrieve discounts configured for one known membership type ID. These are type-level benefits, not the tenant pricebook discount-and-fee catalog.

Inputs: id (required). Returns: object

memberships_types_duration_billing_listA
Read-onlyIdempotent

Retrieve duration and billing configurations under one required membership-type ID. Use this for plan-level term and billing choices; use memberships_types_get for the parent plan and memberships_list for customer memberships.

Inputs: id (required), active. Returns: object

memberships_types_getA
Read-onlyIdempotent

Retrieve a membership type by its ServiceTitan ID. Returns the single upstream record without pagination; use memberships_types_list to search when the ID is unknown.

Inputs: id (required). Returns: object

memberships_types_listA
Read-onlyIdempotent

List one requested page of membership-type definitions using IDs, active state, billing frequency, duration, and created or modified timestamps; includeDurationBilling controls embedded billing details. Use memberships_types_get for one known plan and memberships_list for memberships sold to customers.

Inputs: ids, page, active, duration, +8 more. Returns: object

memberships_types_recurring_service_items_listA
Read-onlyIdempotent

Retrieve the recurring-service items configured under one required membership-type ID. Use memberships_types_get for the parent plan; use memberships_recurring_services_list for recurring services scheduled for customer locations.

Inputs: id (required). Returns: object

payroll_employees_payrolls_listA
Read-onlyIdempotent

List one requested page of payroll periods for a required employee, with status, active-state, and date filters. Use payroll_payrolls_list for a tenant-wide search.

Inputs: employeeId (required), page, active, status, +9 more. Returns: object

payroll_gross_pay_items_listA
Read-onlyIdempotent

List one requested page of gross-pay line items, optionally scoped by employee, payroll IDs, or pay date range. Use this to inspect pay components rather than payroll-period summaries.

Inputs: page, pageSize, employeeId, payrollIds, +4 more. Returns: object

payroll_payroll_adjustments_getA
Read-onlyIdempotent

Retrieve one payroll adjustment by its required ID. Use payroll_payroll_adjustments_list to search when the ID is unknown.

Inputs: id (required), employeeType. Returns: object

payroll_payroll_adjustments_listA
Read-onlyIdempotent

List one requested page of payroll adjustments, optionally filtered by employee IDs and posted timestamp. Use payroll_payroll_adjustments_get for one known adjustment ID.

Inputs: page, pageSize, employeeIds, includeTotal, +2 more. Returns: object

payroll_payroll_settings_employee_getA
Read-onlyIdempotent

Retrieve payroll settings for one employee by the required employee ID. Use payroll_payroll_settings_list to search across workers when the ID is unknown.

Inputs: employeeId (required). Returns: object

payroll_payroll_settings_listA
Read-onlyIdempotent

List one requested page of payroll-setting records across employees and technicians, with active, employee-type, created, and modified filters. Use the employee or technician get tool when a worker ID is known.

Inputs: page, active, pageSize, employeeType, +5 more. Returns: object

payroll_payroll_settings_technician_getA
Read-onlyIdempotent

Retrieve payroll settings for one technician by the required technician ID. Use payroll_payroll_settings_list to search across workers when the ID is unknown.

Inputs: technicianId (required). Returns: object

payroll_payrolls_listA
Read-onlyIdempotent

List one requested page of payroll periods across employees, with employee type, status, active-state, and date filters. Use the employee- or technician-specific payroll tools when that worker ID is known.

Inputs: page, active, status, pageSize, +9 more. Returns: object

payroll_technicians_payrolls_listA
Read-onlyIdempotent

List one requested page of payroll periods for a required technician, with status, active-state, and date filters. Use payroll_payrolls_list for a tenant-wide search.

Inputs: technicianId (required), page, active, status, +9 more. Returns: object

payroll_timesheet_codes_getA
Read-onlyIdempotent

Retrieve one timesheet code by its required ID. Use payroll_timesheet_codes_list to search when the ID is unknown.

Inputs: id (required). Returns: object

payroll_timesheet_codes_listB
Read-onlyIdempotent

Retrieve one requested page of timesheet codes. Use the available filters to narrow results and request subsequent pages explicitly.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

payroll_timesheets_job_listA
Read-onlyIdempotent

List one requested page of timesheets attached to a required job. Use this when the job ID is known; use payroll_timesheets_jobs_list to search across optional comma-delimited job IDs.

Inputs: jobId (required), page, sort, endedOn, +8 more. Returns: object

payroll_timesheets_jobs_listA
Read-onlyIdempotent

List one requested page of job timesheets across jobs, optionally filtered by comma-delimited job IDs. Use payroll_timesheets_job_list when retrieving timesheets for one required job.

Inputs: page, sort, jobIds, endedOn, +8 more. Returns: object

payroll_timesheets_non_job_listA
Read-onlyIdempotent

List one requested page of non-job timesheets, optionally filtered by employee, employee type, dates, or active state. These records are not attached to jobs; use the job timesheet tools for job labor.

Inputs: page, sort, active, pageSize, +7 more. Returns: object

people_employees_exportA
Read-onlyIdempotent

Read the incremental employee export feed for People synchronization. This is the same feed as export_employees; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

people_employees_getA
Read-onlyIdempotent

Retrieve one employee by its required ID. Use people_employees_list to search when the ID is unknown.

Inputs: id (required). Returns: object

people_employees_listA
Read-onlyIdempotent

List one requested page of employees, optionally filtered by IDs, user IDs, name, active state, or dates. Use the get tool for one known ID or the export feed for synchronization.

Inputs: ids, name, page, active, +7 more. Returns: object

people_performance_getA
Read-onlyIdempotent

Retrieve one requested page of marketing performance metrics for a UTC period, segmented by campaign, ad group, or keyword. Use this to compare acquisition performance at one selected grain.

Inputs: toUtc (required), fromUtc (required), performanceSegmentationType (required), page, +2 more. Returns: object

people_technicians_getA
Read-onlyIdempotent

Retrieve one technician by its required ID. Use people_technicians_list to search when the technician ID is unknown.

Inputs: id (required). Returns: object

people_technician_shifts_getA
Read-onlyIdempotent

Retrieve one technician shift by its required ID. Use people_technician_shifts_list to search when the shift ID is unknown.

Inputs: id (required). Returns: object

people_technician_shifts_listA
Read-onlyIdempotent

List one requested page of technician shifts, including normal, on-call, and time-off shifts. Filter by technician, time bounds, text, type, or active state; use the get tool for one known shift ID.

Inputs: page, sort, active, pageSize, +11 more. Returns: object

people_technicians_listA
Read-onlyIdempotent

List one requested page of technicians, optionally filtered by IDs, user IDs, name, active state, or dates. Use the get tool for one known ID or the export feed for synchronization.

Inputs: ids, name, page, active, +7 more. Returns: object

people_trucks_listA
Read-onlyIdempotent

List one requested page of inventory trucks, optionally filtered by IDs, active state, dates, or external-data mapping. externalDataKey and externalDataValues must be supplied together.

Inputs: ids, page, sort, active, +9 more. Returns: object

pricebook_categories_getA
Read-onlyIdempotent

Retrieve a pricebook category by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_categories_list to search when the ID is unknown.

Inputs: id (required). Returns: object

pricebook_categories_listA
Read-onlyIdempotent

List one requested page of pricebook categories using category type, active state, and created or modified timestamps. Use pricebook_categories_get for one known category ID; use the service, material, or equipment list tool for sellable items.

Inputs: page, sort, active, pageSize, +6 more. Returns: object

pricebook_discounts_fees_getA
Read-onlyIdempotent

Retrieve a discount or fee by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_discounts_fees_list to search when the ID is unknown.

Inputs: id (required), externalDataApplicationGuid. Returns: object

pricebook_discounts_fees_listA
Read-onlyIdempotent

List one requested page of pricebook discount and fee items using IDs, active state, created or modified timestamps, and external-data mappings. Use pricebook_discounts_fees_get for a known item; membership-type discounts are a separate plan-level benefit.

Inputs: ids, page, sort, active, +9 more. Returns: object

pricebook_equipment_getA
Read-onlyIdempotent

Retrieve equipment item by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_equipment_list to search when the ID is unknown.

Inputs: id (required), externalDataApplicationGuid. Returns: object

pricebook_equipment_listA
Read-onlyIdempotent

List one requested page of equipment pricebook items using IDs, active state, created or modified timestamps, and external-data mappings. Use pricebook_equipment_get for a known pricebook item; use installed-equipment tools for equipment attached to customer locations.

Inputs: ids, page, sort, active, +9 more. Returns: object

pricebook_materials_cost_types_listA
Read-onlyIdempotent

List the material cost-type definitions available to pricebook material records; this operation has no filters or caller-managed paging. Use pricebook_materials_list for material items and inventory tools for stock transactions.

Inputs: no named parameters. Returns: object

pricebook_materials_getA
Read-onlyIdempotent

Retrieve a material by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_materials_list to search when the ID is unknown.

Inputs: id (required), externalDataApplicationGuid. Returns: object

pricebook_materials_listA
Read-onlyIdempotent

List one requested page of material pricebook items using IDs, cost-type IDs, other-direct-cost state, active state, timestamps, and external-data mappings. Use pricebook_materials_get for a known item, pricebook_materials_cost_types_list for cost metadata, or inventory tools for stock movement.

Inputs: ids, page, sort, active, +11 more. Returns: object

pricebook_materials_markup_getA
Read-onlyIdempotent

Retrieve a material markup range by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_materials_markup_list to search when the ID is unknown.

Inputs: id (required). Returns: object

pricebook_materials_markup_listA
Read-onlyIdempotent

List one requested page of configured material markup ranges using paging, sorting, and total-count controls. Use pricebook_materials_markup_get for a known range ID; use pricebook_materials_list for the material items those pricing rules affect.

Inputs: page, sort, pageSize, includeTotal. Returns: object

pricebook_services_getA
Read-onlyIdempotent

Retrieve a service by its ServiceTitan ID. Returns the single upstream record without pagination; use pricebook_services_list to search when the ID is unknown.

Inputs: id (required), externalDataApplicationGuid. Returns: object

pricebook_services_listA
Read-onlyIdempotent

List one requested page of service pricebook items using IDs, active state, created or modified timestamps, and external-data mappings. Use pricebook_services_get for one known item; use estimates or invoices for services quoted or sold on customer transactions.

Inputs: ids, page, sort, active, +9 more. Returns: object

reporting_dynamic_value_sets_getA
Read-onlyIdempotent

Resolve selectable values for a report dynamic-value-set identifier. Use values from the report definition to supply the required identifier and paging inputs when that report parameter offers dynamic choices.

Inputs: dynamicSetId (required), page, pageSize, includeTotal. Returns: object

reporting_report_categories_listA
Read-onlyIdempotent

List one requested page of report categories with paging and total-count controls. Start here to discover a category ID, then use reporting_reports_list for reports in that category and reporting_reports_get for a report parameter definition.

Inputs: page, pageSize, includeTotal. Returns: object

reporting_reports_data_createA
Read-onlyIdempotent

Execute one requested page of a known report and return the upstream report-data response. First inspect reporting_reports_get for that report's required parameter names, value types, and accepted formats; pass those entries in parameters, and use page, pageSize, and includeTotal to control this request. This generic reporting call is not subject to the intelligence tools' report scheduler or 65-second spacing.

Inputs: reportId (required), parameters (required), reportCategory (required), page, +2 more. Returns: object

reporting_reports_getA
Read-onlyIdempotent

Retrieve one report definition from a known category and report ID, including its parameter contract. Use reporting_reports_list to discover reports and reporting_reports_data_create to execute the selected definition.

Inputs: reportId (required), reportCategory (required). Returns: object

reporting_reports_listA
Read-onlyIdempotent

List report definitions within a known report category. Use reporting_report_categories_list to discover category IDs, then use reporting_reports_get for one report definition before executing it.

Inputs: reportCategory (required), page, pageSize, includeTotal. Returns: object

scheduling_appointment_assignments_listA
Read-onlyIdempotent

Find one page of technician-to-appointment assignments by assignment IDs, appointment IDs, job ID, active state, or creation and modification dates. Use dispatch_appointments_get or dispatch_appointments_list for the appointment records themselves; this tool returns the assignment relationships.

Inputs: ids, page, sort, jobId, +8 more. Returns: object

scheduling_business_hours_listA
Read-onlyIdempotent

Retrieve the tenant business-hours configuration used for scheduling availability. This returns configured hours rather than appointment records or calculated open capacity.

Inputs: no named parameters. Returns: object

scheduling_non_job_appointments_getA
Read-onlyIdempotent

Retrieve a non-job appointment by its ServiceTitan ID. Returns the single upstream record without pagination; use scheduling_non_job_appointments_list to search when the ID is unknown.

Inputs: id (required). Returns: object

scheduling_non_job_appointments_listA
Read-onlyIdempotent

List one requested page of non-job appointments using IDs, technician, timesheet code, schedule visibility, active state, start bounds, and created or modified timestamps. Use scheduling_non_job_appointments_get for a known appointment; use dispatch appointment tools for appointments attached to jobs.

Inputs: ids, page, sort, pageSize, +11 more. Returns: object

scheduling_teams_getA
Read-onlyIdempotent

Retrieve a team by its ServiceTitan ID. Returns the single upstream record without pagination; use scheduling_teams_list to search when the ID is unknown.

Inputs: id (required). Returns: object

scheduling_teams_listA
Read-onlyIdempotent

List one requested page of scheduling teams using includeInactive and created or modified timestamp filters. Use scheduling_teams_get for one known team ID; use scheduling appointment assignments for technician-to-appointment assignments rather than team definitions.

Inputs: page, sort, pageSize, includeTotal, +5 more. Returns: object

scheduling_zones_getA
Read-onlyIdempotent

Retrieve a zone by its ServiceTitan ID. Returns the single upstream record without pagination; use scheduling_zones_list to search when the ID is unknown.

Inputs: id (required). Returns: object

scheduling_zones_listA
Read-onlyIdempotent

List one requested page of scheduling zones using active state and created or modified timestamp filters. Use scheduling_zones_get for one known zone ID; use scheduling_business_hours_list for configured operating hours rather than geographic zone definitions.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

settings_activities_exportA
Read-onlyIdempotent

Read the incremental timesheet-activity export feed for Settings workflows. This is the same feed as export_activities; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

settings_activity_categories_exportA
Read-onlyIdempotent

Read the incremental activity-category export feed for Settings synchronization. Use the list or get tools for filtered browsing or a known ID. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

settings_activity_categories_getA
Read-onlyIdempotent

Retrieve one timesheet activity category by its required ID. Use settings_activity_categories_list to search when the ID is unknown.

Inputs: id (required). Returns: object

settings_activity_categories_listA
Read-onlyIdempotent

List one requested page of timesheet activity categories with active-state, date, and sort controls. Use the get tool for one known category or the export feed for synchronization.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

settings_activity_codes_exportA
Read-onlyIdempotent

Read the incremental activity-code export feed for Settings workflows. This is the same feed as export_activity_codes; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

settings_activity_codes_getA
Read-onlyIdempotent

Retrieve one payroll activity code by its required ID. Use settings_activity_codes_list to search when the ID is unknown.

Inputs: id (required). Returns: object

settings_activity_codes_listA
Read-onlyIdempotent

List one requested page of payroll activity codes with active-state, date, and sort controls. Use the get tool for one known code or the export feed for synchronization.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

settings_activity_types_getA
Read-onlyIdempotent

Retrieve one timesheet activity type by its required ID. Use settings_activity_types_list to search when the ID is unknown.

Inputs: id (required). Returns: object

settings_activity_types_listA
Read-onlyIdempotent

List one requested page of timesheet activity types with active-state, date, and sort controls. Use the get tool for one known type ID.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

settings_business_units_getA
Read-onlyIdempotent

Retrieve one business unit by its required ID. Use settings_business_units_list to search when the ID is unknown.

Inputs: id (required), externalDataApplicationGuid. Returns: object

settings_business_units_listA
Read-onlyIdempotent

List one requested page of business units, optionally filtered by IDs, name, active state, dates, or external-data application. Use the get tool for one known ID or the export feed for synchronization.

Inputs: ids, name, page, active, +7 more. Returns: object

settings_tag_types_exportA
Read-onlyIdempotent

Read the incremental tag-type export feed for Settings workflows. This is the same feed as export_tag_types; use whichever name is available and do not fetch both. Continue immediately with continueFrom while hasMore is true; when false, retain it and wait before polling again. includeRecentChanges may repeat records.

Inputs: from, includeRecentChanges. Returns: object

settings_tag_types_listA
Read-onlyIdempotent

List one requested page of tag types with active-state, date, and sort controls. Use the export feed for incremental synchronization; this endpoint is for paginated browsing.

Inputs: page, sort, active, pageSize, +5 more. Returns: object

settings_tasks_getA
Read-onlyIdempotent

Retrieve one task by its required ID. Use settings_tasks_list to search when the ID is unknown.

Inputs: id (required), includeSubtasks. Returns: object

settings_tasks_listA
Read-onlyIdempotent

List one requested page of employee tasks using status, assignment, related-record, date, priority, and other filters. Use settings_tasks_get for one known task ID; statuses is preferred over deprecated isClosed.

Inputs: ids, name, page, sort, +27 more. Returns: object

settings_user_roles_listA
Read-onlyIdempotent

List one requested page of user roles, optionally filtered by IDs, name, active state, creation date, or employee type. Use this catalog to resolve role IDs and availability.

Inputs: ids, name, page, active, +5 more. Returns: object

st_health_checkA
Read-onlyIdempotent

Verify authentication and representative tenant read access. Use st_readiness_check for report and module compatibility.

Inputs: no named parameters. Returns: object

st_readiness_checkA
Read-onlyIdempotent

Read-only compatibility manifest: authentication, representative module read access, report fields/parameters and definition fingerprints. Does not certify write scopes or metric totals.

Inputs: reports. Returns: object

st_result_readA
Read-onlyIdempotent

Retrieve a stored large result as bounded JSON text chunks. Start at offset 0, concatenate text in nextOffset order, then parse JSON. Results expire after five minutes and belong to this session.

Inputs: resultId (required), offset. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 264 tools

    Disambiguation2/5

    There are multiple near-identical and explicitly duplicated tools, including export_employees/people_employees_export, export_activities/settings_activities_export, marketing_calls_v2_list/marketing_calls_v3_list, and dispatch_job_cancel_reasons_list/dispatch_jobs_cancel_reasons_list. Many descriptions try to disambiguate, but the sheer number of overlapping feeds and singular/plural variants makes misselection likely.

    Naming Consistency3/5

    Most tools follow a readable lowercase snake_case domain_entity_verb pattern, but conventions are mixed: top-level export_* feeds coexist with *_export alias tools, v2/v3 suffixes appear inconsistently, and names like marketing_scheduler_schedulersessions or crm_bookings_provider_contacts_list break the rhythm. The naming is not chaotic, but it is not uniform enough for a higher score.

    Tool Count1/5

    With 264 tools, this is an extreme count even for a broad ServiceTitan integration. The surface includes dozens of near-duplicate export feeds, catalog/list/get variants, and custom intel tools that could have been consolidated. This volume will overwhelm agents and makes tool selection impractical.

    Completeness2/5

    The read/list/export coverage is broad across CRM, dispatch, accounting, inventory, payroll, marketing, and pricebook, but the entire surface is read-only with no create, update, or delete operations. There are also odd gaps where entities only have exports or only have list/get tools, and several duplicate feeds suggest an incomplete or inconsistent lifecycle model.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A remote MCP server that exposes the ServiceTitan API as tools, enabling Claude and other clients to manage customers, jobs, pricebook, invoicing, and more with write safety and built-in observability.
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      A comprehensive MCP server covering the full GoHighLevel API surface with 651 tools, enabling management of contacts, opportunities, calendars, invoices, and more through natural language, with multi-tenant support and read-only safety defaults.
      500
      1
      MIT