Trackings

The Trackings MCP Server enables Claude Desktop to integrate with trackings.ai by exposing a set of operations you can run from Claude. It acts as a bridge between Claude and Trackings, letting you list projects, fetch scans, run scans, and retrieve results through a standardized MCP interface.

How to use

You connect to the Trackings MCP Server from your MCP client in Claude Desktop. Once configured, you can perform common automation tasks such as listing all projects, listing scans for a project, inspecting scan runs, triggering new scan runs, and retrieving results and credits. Use the available tools to interact with Trackings data and control scans directly from Claude.

How to install

Prerequisites: you need the MCP runtime tool installed (the installation uses a runtime command called uvx). Install the MCP server using the exact command shown below.

uvx --from git+https://github.com/peterw/trackings-mcp trackings-mcp

Configuration and setup

Configure Claude Desktop to use the Trackings MCP Server by adding an mcpServers entry in your Claude desktop configuration. This example shows how to wire the server with the necessary environment variables for authentication and API access.

{
  "mcpServers": {
    "trackings": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/peterw/trackings-mcp", "trackings-mcp"],
      "env": {
        "TRACKINGS_API_KEY": "your-api-key",
        "TRACKINGS_API_URL": "https://your-convex-deployment.convex.site"
      }
    }
  }
}

Additional configuration notes

The Trackings MCP Server exposes a set of endpoints that you can call through Claude Desktop to manage projects, scans, scan runs, and results. The environment variables you provide in the configuration are required for authentication and API access.

Tools and endpoints handled by this MCP server

The server supports the following operations. Each operation corresponds to a specific action you can perform from Claude Desktop.

Security considerations

Keep your API key secure. Do not expose TRACKINGS_API_KEY in shared configurations. Use your secure secret management practices and restrict access to the Claude Desktop configuration that contains these credentials.

Available tools

list_projects

List all projects accessible to Trackings from within Claude Desktop.

list_scans

List all scans for a specific project.

list_scan_runs

List all scan runs for a given project or scan.

get_scan_run

Retrieve detailed information for a specific scan run.

get_scan_results

Fetch consolidated keyword results for a particular run.

get_credits

Get the current credit balance for the Trackings account.

create_scan

Create a new scan configuration for a project.

trigger_scan_run

Trigger a new scan run for a project or scan.