Skip to content

MCP server

Ask questions about your tracked assets in plain language. Blecon Track exposes a Model Context Protocol (MCP) server that gives AI assistants — including Claude Code and Claude Desktop — direct access to your tracking data.

Once connected, you can ask things like "which assets are currently in the loading bay?" or "show me the position history for forklift #3 over the last 24 hours" and get live answers, without writing API calls or navigating the UI.

Endpoint

https://api.blecon.net/tracker/mcp/

Connecting Claude Code

  1. Add the MCP server to your Claude Code settings (~/.claude/settings.json):

    {
  "mcpServers": {
    "blecon-tracker": {
      "type": "http",
      "url": "https://api.blecon.net/tracker/mcp/"
    }
  }
}

  2. Start a new Claude Code session — Claude Code will open a browser window to sign in to your Blecon account. Once authenticated, the tracker tools are available automatically.

No API key is required. The MCP server uses OAuth and your existing Blecon account credentials.

Available tools

The MCP server exposes tools across five areas:

Assets

Tool What it does
list_assets List all assets in a workspace with current position, zone, and status
get_asset_details Full details for a specific asset
search_assets Find assets by name or ID substring
get_asset_children List child assets associated with a parent
update_asset Update an asset's name, type, or custom fields

Position and sensor history

Tool What it does
get_asset_position_history Position trail for a device over a time window (up to 7 days)
get_sensor_history Temperature, humidity, and battery readings over time

Zones

Tool What it does
list_zones List all zones in a workspace
get_zone_details Full zone details including geometry and asset count
get_zone_occupancy Assets currently inside a specific zone
get_zone_transitions Zone entry and exit events over a time window
create_zone Create a new coordinate zone (bounding box or polygon)

Alert rules and violations

Tool What it does
list_alert_rules All alert rules configured in a workspace
get_alert_rule Details for a specific alert rule
create_alert_rule Create a new alert rule
update_alert_rule Update or enable/disable an existing rule
get_violations Active, resolved, or all violations
get_violation_stats Violation counts by severity and rule type

Analytics

Tool What it does
get_fleet_summary Total assets, active/offline counts, zone and violation summary
get_location_stats Position data volume across 1h, 24h, and 7d windows

Example prompts

Which assets are currently in the "Warehouse Floor" zone?

Show me the position history for asset urn:uuid:abc123 over the last 48 hours.

List all alert rules in workspace trk_xxx — are any currently disabled?

How many violations are active right now, and what's the breakdown by severity?

Search for assets with "forklift" in their name.

Questions? Contact Blecon support — we're happy to help.