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 can vary basedwith on authenticationthe scopes approved for that connection and with what the client requirements.

supports.

SiteTrax.io MCPRead capabilities use sitetrax:read. Notification and digest capabilities require sitetrax:notifications:write and must be approved separately.

Capability groupWhat you can includeask theforScope following groups.

required

Read-only
Projects and Sites

Use SiteTrax.io to:

    List projectssites

    Projects available to theyour authenticated user.

    Retrieveaccount, project details.

    detail and

    Review project configuration.

    Reviewconfiguration, recent activity.

    Reviewactivity, cameras and safegate integration configuration.

    Compareconfiguration, activity compared across projects.

    projects
    sitetrax:readYes
    AssetsAsset observation

    Assets

    Use SiteTrax.io to:

      Search for asset observations.

      Findsearch, the latest observation for an asset.

      Retrieveidentifier, detailed asset records.

      Reviewrecords, asset history.

      Retrieve availablehistory, detection images.

      Retrieve availableimages, video metadata.

      metadata,

      Filter by project, camera, asset type, status, identifier, or time.

      Analytics

      Use SiteTrax.io to:

        Count observations.

        Calculate distinct asset totals.

        Group activityfiltering by project, camera, type, status, identifier or time

        sitetrax:readYes
        AnalyticsObservation counts, distinct asset totals, grouping by project, camera, type, status or time period, orsequence other supported dimensions.

        Analyze operational sequences.

        Calculateanalysis, observed durations between defined operational boundaries.

        Reviewboundaries, activity trends.

        Identifytrends, potential anomalies.

        anomalies

        sitetrax:readYes
        Review cameraand 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 health.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.

        Review and Exception Analysis

        Use SiteTrax.io to:

          Review processing status.

          Find records matching defined review criteria.

          Investigate unreadable or unusual results.

          Review supplied-list exceptions.

          Inspect exact asset records when additional context is required.

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

          SiteTrax.io

          Grant Referencesitetrax:notifications:write Informationonly

          Thewhen MCPthe serverclient canand alsothe provideintended workflow require it. Integrations that expose SiteTrax.io productthrough anda operationalread-only referencesurface, information,including including:the Microsoft 365 Copilot connector, do not receive it.

            Supported capture methods.

            SiteTrax.io data fields.

            Asset types.

            Processing status codes.

            SiteTrax.io terminology.

            Operational metric definitions.

            Product capabilities.

            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.