# HelloTracks — how to use (mcp.ai)

Connect your HelloTracks account and use 10 tools for project management straight from your AI agent. Connect with your own API key. HelloTracks is a location-based workforce management platform for dispatching jobs, optimizing routes, tracking mobile teams, and managing field operations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hello_tracks?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hello_tracks_archive_job`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hello_tracks`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hello_tracks/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hello_tracks/archive/job` — Archive one HelloTracks job while keeping it recoverable in HelloTracks.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/hello_tracks/delete/job` — Permanently delete one HelloTracks job; use only for a disposable or intentionally removed job.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/hello_tracks/get/account/context` — Identify the connected HelloTracks account and return its company, teams, units, and API-enabled state.
- `POST https://api.mcp.ai/api/hello_tracks/get/current/locations` — Read precise latest-known GPS coordinates and available movement, elevation, and battery telemetry for selected visible HelloTracks members, optionally with addresses, without pinging their devices.
  - body: { member_ids: string[], include_address?: boolean }
- `POST https://api.mcp.ai/api/hello_tracks/get/job` — Retrieve one HelloTracks job by its job ID.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/hello_tracks/list/jobs` — List HelloTracks jobs with optional time, progress, archive, external-ID, and assignee filters, returning one controllable page.
  - body: { progress?: string, external_id?: string, next_cursor?: string, created_since?: integer, updated_since?: integer, include_archived?: boolean, assignee_username?: string }
- `POST https://api.mcp.ai/api/hello_tracks/list/members` — Search visible HelloTracks members for identity and assignment details without returning location or device telemetry.
  - body: { query?: string, max_results?: integer }
- `POST https://api.mcp.ai/api/hello_tracks/list/places` — Find visible HelloTracks places by name or place IDs for use in job planning.
  - body: { query?: string, place_ids?: string[], max_results?: integer }
- `POST https://api.mcp.ai/api/hello_tracks/update/job` — Partially update the editable details of one existing HelloTracks job.
  - body: { date?: string, notes?: string, title?: string, job_id: string, address?: string, contact?: object, place_id?: string, priority?: integer, external_id?: string, time_window?: object, assignee_username?: string }
- `POST https://api.mcp.ai/api/hello_tracks/upsert/job` — Create a HelloTracks job, or update the existing job when the supplied external ID already matches one.
  - body: { date?: string, notes?: string, title: string, address?: string, contact?: object, place_id?: string, priority?: integer, external_id?: string, time_window?: object, assignee_username?: string }

## Example prompts
- "What can I do in HelloTracks?"
- "Show me a summary of my HelloTracks account"

## More
- Page: https://mcp.ai/hello_tracks
- Agent spec (llms.txt): https://mcp.ai/hello_tracks/llms.txt
- Postman collection: https://mcp.ai/hello_tracks/postman.json