Skip to main content

SiteTrax.io MCP Server

Connect AI assistants and MCP-compatible applications directly to SiteTrax.io operational data and SiteTrax.io Intelligence.

Overview

The SiteTrax.io Model Context Protocol (MCP) server provides secure access to SiteTrax.io operational data through compatible AI applications and MCP clients.

The MCP server lets authorized users query the same SiteTrax.io projects and operational information that their SiteTrax.io account is permitted to access. This can include asset observations, project activity, operational metrics, exceptions, images, video metadata, equipment movement history, camera health, and other SiteTrax.io Intelligence capabilities.

SiteTrax.io remains the system of record. The MCP server provides controlled access to SiteTrax.io data and capabilities based on the authenticated user's permissions.

02_SiteTraxio_MCP_Server_Feature_440x250.jpg

MCP Server Endpoint

Use the following remote MCP endpoint:

https://mcp.sitetrax.io/mcp

The SiteTrax.io MCP server uses HTTPS and is designed for remote MCP clients that support Streamable HTTP.

Requirements

To connect to the SiteTrax.io MCP server, you need:

  • An active SiteTrax.io account.account with verified email. Complete verification before starting the assistant connection.

  • Access to at least one SiteTrax.io project, site, or yard.yard for useful operational answers. OAuth can succeed with no shared projects and return an empty project list.

  • An MCP-compatible client that supports remote HTTPS MCP servers.

  • OAuth authentication support in the MCP client.

  • Any SiteTrax.io permissions required for the data or capabilities you want to use.

Your MCP client can only access SiteTrax.io information available to your authenticated SiteTrax.io account. A published Intelligence profile is optional for ordinary MCP access. Before connecting, confirm the intended account in the application. Native application sign-in and external-assistant OAuth approval are separate steps. See Account Access and OAuth.

Connect to SiteTrax.io

The exact setup interface depends on the MCP client you use.

In most compatible clients:

  1. Open the application's MCP, integrations, connectors, or tools settings.

  2. Add a new remote MCP server.

  3. Enter the SiteTrax.io MCP endpoint:

    https://mcp.sitetrax.io/mcp

  4. Start the connection.

  5. When prompted, sign in to SiteTrax.io.

  6. Review the requested SiteTrax.io permissions.

  7. Authorize the connection.

  8. Return to your MCP client.

  9. Confirm that SiteTrax.io tools are available.available, then ask: “Using SiteTrax.io, list the projects I have access to.” Compare the result with Projects in the application under the same account.

No SiteTrax.io password should be entered directly into the MCP configuration. Authentication is completed through the SiteTrax.io OAuth authorization process.

Authentication and Permissions

SiteTrax.io uses OAuth-based authorization for protected MCP capabilities.

Permissions are scope-based. The tools available to an MCP client depend on the scopes approved for that connection.

Read Access

Standard operational queries use SiteTrax.io read access.

Read access can include:

  • Projects and sites shared with the user.

  • Asset observations.

  • Container, chassis, trailer, and other supported asset identifiers.

  • Project activity.

  • Asset history.

  • Operational aggregates.

  • Status and exception information.

  • Camera and processing health.

  • Detection images and available media metadata.

  • SiteTrax.io product and operational reference information.information, selected published profile context, your notification list and notification delivery history.

Read access does not grant access to SiteTrax.io projects that have not been shared with the authenticated user.

Additional Capabilities

Some MCP integrations can support additional SiteTrax.io capabilities, such as notifications or scheduled digests.

TheseCreating capabilitiesa requiredetection separatealert, permissions.creating Fora example,scheduled notification-managementemail operationsdigest, requireor cancelling one of your notifications requires read access plus sitetrax:notifications:write. Listing notifications and reading delivery history requires only sitetrax:read. The additional write permission may be requested during initial connection or later, depending on the applicable notification write scope.client.

Grant additional permissions only when the MCP client and intended workflow require them.

What You Can Ask

The SiteTrax.io MCP server supports natural-language interaction with SiteTrax.io operational data.

Examples include:

Find an Asset

Prompt

Where was container SITU 123456 7 last observed?

Result

SiteTrax.io can return the most recent authorized observation of that asset, including available project, time, capture, and operational metadata.

Review Site Activity

Prompt

Summarize activity at my SiteTrax.io sites for the last seven days.

Result

SiteTrax.io can calculate activity across the projects available to your account and return operational totals and trends for the requested period.

Analyze Asset Types

Prompt

Show today's SiteTrax.io detections by asset type.

Result

SiteTrax.io can provide server-calculated totals and breakdowns for the requested sites and time period.

Review Processing Status

Prompt

Break down today's detections by status code and asset type.

Result

SiteTrax.io can return processing results grouped by status and asset type so that the results can be interpreted correctly.

Find Exceptions

Prompt

Show me records that may require review today.

Result

SiteTrax.io can retrieve records that meet the applicable review criteria for projects available to the user.

Check Operational Health

Prompt

Were there any unusual volume gaps at my sites this week?

Result

SiteTrax.io can analyze authorized site activity and identify potential low-volume periods, repeated observations, or other operational anomalies supported by the available data.

Analyze Equipment Movement

Prompt

What was the observed time between gate-in and gate-out for trailers this week?

Result

Where the site configuration and available observations support the calculation, SiteTrax.io can perform server-side sequence and duration analysis using defined operational boundaries.

Available Capability Groups

The tools exposedavailable to a specific MCP client vary with the scopes approved for that connectionscopes and with what the client supports.support. Read capabilities use sitetrax:read. NotificationCreating andor digestcancelling capabilitiesnotifications requirealso requires sitetrax:notifications:write, andwhich mustmay be approved separately.initially or later. See Alerts and Scheduled Digests for supported workflows.

Capability group What you can ask for Scope required Read-only
Projects and sites Projects available to your account, project detail and configuration, recent activity, cameras and gate configuration, activity compared across projects sitetrax:read Yes
Assets Asset observation search, the latest observation for an identifier, detailed asset records, asset history, detection images, video metadata, filtering by project, camera, type, status, identifier or time sitetrax:read Yes
Analytics Observation counts, distinct asset totals, grouping by project, camera, type, status or time period, sequence analysis, observed durations between defined operational boundaries, activity trends, potential anomalies sitetrax:read Yes
Review and exceptions Processing status review, records matching defined review criteria, unreadable or unusual results, supplied-list exceptions, persisted audit feedback, and exact asset records when more context is needed sitetrax:read Yes
Video Video search and individual video detail records sitetrax:read Yes
Camera and processing health Camera activity and scan health across the projects available to your account sitetrax:read Yes
Reference information Supported capture methods, SiteTrax.io data fields, asset types, processing status codes, terminology, operational metric definitions and product capabilities sitetrax:read Yes
Notification history
Listing your alerts and digests and reading their delivery history sitetrax:read Yes Published profile context Selected facts and priorities from your published personal profile; retrieval and use depend on the assistant sitetrax:read Yes Notifications and digests Creating,Creating listingdetection alerts and scheduled email digests, and cancelling alerts,your and creating recurring email digestsnotifications sitetrax:read + sitetrax:notifications:write No

SiteTrax.io performs analytical reductions on the server. MCP clients do not need to download large raw datasets to calculate supported SiteTrax.io metrics. They can retrieve permitted supporting observations and records explaining an analytical result. Query results are returned to the assistant provider you choose; this is not a zero-disclosure connection.

A processing status is not automatically a physical-condition or operational exception. The asset type, status code and operational context must be interpreted together.

Grant sitetrax:notifications:write only when the client and the intended workflow require it. Integrations that expose SiteTrax.io through a read-only surface, including the Microsoft 365 Copilot connector, do not receive it.

The public Intelligence profile tool returns selected published facts and priorities. It does not return the saved working brief, custom instructions or response-style preferences. A published profile is personal and optional for ordinary operational queries. Projects selected in the profile provide context; current project sharing remains the access boundary.

Supported Capture Data

Depending on a customer's SiteTrax.io configuration, operational data can include information generated through SiteTrax.io capture methods such as:

  • SiteTrax Mobile

  • SiteTrax Snap

  • SiteTrax Gate

  • SiteTrax Drive

  • Other supported camera-based capture configurations

Detected or processed identifiers can include supported equipment and operational identifiers such as:

  • Intermodal container IDs

  • Chassis IDs

  • Trailer IDs

  • USDOT numbers

  • License plate information where supported by the configured solution

  • Other configured OCR or operational outputs

Available metadata can include timestamps, project information, camera information, location data, status information, images, direction, and asset relationships.

Images and Media

Some SiteTrax.io records include links to detection images or video-related metadata.

Media availability depends on:

  • The SiteTrax.io project configuration.

  • The authenticated user's access.

  • Record retention.

  • Redaction settings.

  • The type of capture.

If a record is configured as redacted, the MCP server can withhold media while still returning permitted operational metadata.

Data Access and Security

The SiteTrax.io MCP server uses the permissions of the authenticated SiteTrax.io user.

Connecting an MCP client does not automatically give that client access to every SiteTrax.io customer, project, or site.

Users can only query information made available to their SiteTrax.io account.

Remote MCP traffic uses HTTPS.

OAuth access tokens are used to authorize protected requests. Do not place access tokens, passwords, or secrets into prompts.

Data Accuracy and Interpretation

SiteTrax.io returns operational observations and processing results.

Not every stored result should be interpreted as a verified physical event without considering its type and processing status.

For example:

  • A status can describe an OCR or validation outcome.

  • Some records can represent structural or synthetic pairing results.

  • A USDOT number identifies a registered motor carrier and does not uniquely identify an individual tractor.

  • An unreadable asset result does not by itself prove that the physical asset is damaged.

  • Timing between camera observations establishes an observed interval between defined boundaries. It does not automatically establish the cause of that interval.

When operational decisions depend on a result, use the supporting SiteTrax.io record and available evidence.

Troubleshooting

Symptom Likely cause What to do
The MCP client cannot connect The client does not support remote HTTPS MCP servers, or a network control is blocking the endpoint Confirm the endpoint is https://mcp.sitetrax.io/mcp, that the client supports remote HTTPS MCP servers and OAuth, and that no network or security control blocks the connection
Authentication never starts The client only supports local stdio MCP servers A stdio-only client cannot reach a remote endpoint. Use a client that supports remote MCP servers with OAuth
Authentication succeeds but no projects appear The signed-in account has no shared projects, or a different account was used Confirm you signed in with the intended SiteTrax.io account and that at least one project is shared with it. This is a sharing question rather than an authentication one
A tool reports that another OAuth scope is required The operation needs sitetrax:notifications:write ReconnectFor thenotification integrationcreation andor cancellation, approve the additionalextra permission only if thatthe capabilityworkflow isneeds requiredit. ChatGPT may prompt for yourit workflowwhen you request the action. Other clients must request the scope and have a compatible registration; reconnecting with the same read-only request will not add it. Microsoft’s federated connector remains read-only
An asset cannot be found Incomplete identifier, the wrong time window, or the project is not shared with your account Use the complete identifier, check its spelling, widen the time period, name the project or site, and confirm your account can reach that project
Results are too broad The prompt carries no operational context Add the project or site, a date or time range, the asset type, the camera, the status, or the exact equipment identifier
An image or video is not available Project configuration, record retention, user permissions, or redaction Media can be withheld while permitted operational metadata is still returned. The absence of media does not mean the underlying record is unavailable

For better results:

  • Name SiteTrax.io in the prompt.

  • Identify the site or project when possible.

  • Give a specific date or time range.

  • Specify the type of asset.

  • Use the exact equipment identifier when searching for one asset.

  • Ask for a breakdown when comparing activity.

  • Ask for supporting observations when a result will be used operationally.

Example:

Using SiteTrax.io, summarize container and chassis activity at the Utah site for the last seven days and break the results down by status code and asset type.

Known Issues and Limitations

  • Access is limited to the SiteTrax.io projects shared with the authenticated account. Connecting an MCP client does not widen SiteTrax.io permissions.

  • The server exposes MCPprovides tools and resources. MCPCurrent promptssource arealso notregisters exposed.four prompts: project_ops_review, anomaly_scan, carrier_mix and investigate_asset. Prompt availability and presentation depend on the deployed catalog and the client; discover the connected server’s capabilities.

  • The endpoint is remote. A client that only supports local stdio MCP servers cannot connect to it.

  • Communication uses Streamable HTTP. Server-Sent Events transport is not supported.

  • Detection images and video can be withheld by project configuration, record retention, user permissions or redaction, while permitted operational metadata is still returned.

  • An asset record is one stored processing result. It is not necessarily one physical asset or one direct observation, and combined container and chassis processing can add synthetic pair-side rows.

  • Sequence and duration results depend on camera placement and on observations that can be paired reliably. Where a required pairing is not available, SiteTrax.io reports the limitation rather than estimating a value.

  • Tool names, arguments and response shapes can change between server versions. Ask SiteTrax.io for its current schema rather than assuming a fixed contract.

Support

For SiteTrax.io MCP assistance, contact us at https://www.sitetrax.io/contact

When reporting a problem, include:

  • The MCP client you are using.

  • The approximate time of the issue.

  • The SiteTrax.io account email.

  • The project or site involved.

  • The prompt or operation you attempted.

  • The error message, if one was shown.

Do not send passwords, OAuth tokens, client secrets, or other credentials by email.

Privacy Policy

https://sitetrax.io/privacy-policy/

Terms of Service

https://sitetrax.io/tos/

About Model Context Protocol

Model Context Protocol is an open protocol that enables AI applications to connect to external tools and data sources.

Remote MCP servers can use Streamable HTTP for communication and OAuth-based authorization for protected resources.

SiteTrax.io implements MCP to make authorized physical-operations data available to compatible AI applications while retaining SiteTrax.io as the source system.