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.

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.

  • Access to at least one SiteTrax.io project, site, or yard.

  • 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.

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.

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.

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.

These capabilities require separate permissions. For example, notification-management operations require the applicable notification write scope.

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 exposed to a specific MCP client vary with the scopes approved for that connection and with what the client supports. Read capabilities use sitetrax:read. Notification and digest capabilities require sitetrax:notifications:write and must be approved separately.

Capability groupWhat you can ask forScope requiredRead-only
Projects and sitesProjects available to your account, project detail and configuration, recent activity, cameras and gate configuration, activity compared across projectssitetrax:readYes
AssetsAsset 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 timesitetrax:readYes
AnalyticsObservation counts, distinct asset totals, grouping by project, camera, type, status or time period, sequence analysis, observed durations between defined operational boundaries, activity trends, potential anomaliessitetrax:readYes
Review and exceptionsProcessing status review, records matching defined review criteria, unreadable or unusual results, supplied-list exceptions, exact asset records when more context is neededsitetrax:readYes
VideoVideo search and individual video detail recordssitetrax:readYes
Camera and processing healthCamera activity and scan health across the projects available to your accountsitetrax:readYes
Reference informationSupported capture methods, SiteTrax.io data fields, asset types, processing status codes, terminology, operational metric definitions and product capabilitiessitetrax:readYes
Notifications and digestsCreating, listing and cancelling alerts, and creating recurring email digestssitetrax:notifications:writeNo

SiteTrax.io performs analytical reductions on the server. MCP clients do not need to download large raw datasets to calculate supported SiteTrax.io metrics.

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.

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

The MCP Client Cannot Connect

Confirm that the configured endpoint is:

https://mcp.sitetrax.io/mcp

Also confirm that:

  • The MCP client supports remote HTTPS MCP servers.

  • The client supports OAuth authentication.

  • Network or security controls are not blocking the connection.

Authentication Does Not Start

Confirm that your MCP client supports OAuth for remote MCP servers.

If the client only supports local stdio MCP servers, it cannot connect directly to the SiteTrax.io remote endpoint.

Authentication Succeeds but No Projects Appear

The MCP server follows your SiteTrax.io permissions.

Confirm that:

  • You signed in with the intended SiteTrax.io account.

  • Your account has access to one or more SiteTrax.io projects.

  • The required project has been shared with your account.

A Tool Reports That Another OAuth Scope Is Required

Some SiteTrax.io operations require permissions beyond standard read access.

Reconnect the integration and approve the additional permission only if that capability is required for your workflow.

An Asset Cannot Be Found

Try:

  • Using the complete asset identifier.

  • Confirming the identifier spelling.

  • Expanding the requested time period.

  • Specifying the project or site.

  • Confirming that your account has access to the project containing the observation.

Results Are Too Broad

Add more operational context to the prompt.

For example, specify:

  • Project or site

  • Date or time range

  • Asset type

  • Camera

  • Status

  • Asset identifier

Instead of:

Show me activity.

Use:

Show container activity at the Norfolk yard from August 17 through August 19.

An Image or Video Is Not Available

Media can be unavailable because of project configuration, record retention, user permissions, or redaction.

The absence of media does not necessarily mean the underlying operational 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.

Support

For SiteTrax.io MCP assistance, contact:

[email protected]

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.