Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

tiretrack-mcp

MCP server for TireTrack project management. Manage projects, issues, sprints, and teams from any AI assistant that supports the Model Context Protocol.

The TireTrack Settings → MCP Server Setup page renders the exact config block for your environment and chosen client (Claude Code / Codex CLI / Gemini CLI). Use that as the canonical source — this README is a reference for offline setup.

Tools

Category Tools
Projects list_projects, get_project, create_project
Members list_project_members, add_project_member
Issues list_issues, get_issue, get_issue_by_key, create_issue, update_issue
Comments list_comments, add_comment
Sprints list_sprints, get_sprint_metrics
Search search_issues, find_similar_issues
Users list_users, get_current_user

Quick Start

uvx tiretrack-mcp

Using pip

pip install tiretrack-mcp
tiretrack-mcp

Configuration

Set these environment variables:

Variable Required Description
TIRETRACK_API_URL Yes API base URL — https://api.tiretrack.mi.tirerack.com (prod) or https://api-dev.tiretrack.mi.tirerack.com (dev)
TIRETRACK_API_TOKEN Yes Personal access token minted at Settings → Security → Personal Access Tokens

Tokens look like tt_pat_…, expire after 90 days by default, and can be revoked at any time from the same page.

The examples below use ${TIRETRACK_API_TOKEN} so the value resolves from your shell environment. If you'd rather not export it, paste the token string directly into the TIRETRACK_API_TOKEN field instead.

Claude Code / Claude Desktop

Stable (production):

{
  "mcpServers": {
    "tiretrack": {
      "command": "uvx",
      "args": ["--refresh", "tiretrack-mcp"],
      "env": {
        "TIRETRACK_API_URL": "https://api.tiretrack.mi.tirerack.com",
        "TIRETRACK_API_TOKEN": "${TIRETRACK_API_TOKEN}"
      }
    }
  }
}

Dev (pre-release):

{
  "mcpServers": {
    "tiretrack": {
      "command": "uvx",
      "args": ["--refresh", "--prerelease", "allow", "tiretrack-mcp"],
      "env": {
        "TIRETRACK_API_URL": "https://api-dev.tiretrack.mi.tirerack.com",
        "TIRETRACK_API_TOKEN": "${TIRETRACK_API_TOKEN}"
      }
    }
  }
}

--refresh checks PyPI for newer versions on each invocation. --prerelease allow installs .dev pre-release versions.

OpenAI Codex CLI

Stable (production):

# .codex/config.toml
[mcp_servers.tiretrack]
command = "uvx"
args = ["--refresh", "tiretrack-mcp"]

[mcp_servers.tiretrack.env]
TIRETRACK_API_URL = "https://api.tiretrack.mi.tirerack.com"
TIRETRACK_API_TOKEN = "${TIRETRACK_API_TOKEN}"

Dev (pre-release):

# .codex/config.toml
[mcp_servers.tiretrack]
command = "uvx"
args = ["--refresh", "--prerelease", "allow", "tiretrack-mcp"]

[mcp_servers.tiretrack.env]
TIRETRACK_API_URL = "https://api-dev.tiretrack.mi.tirerack.com"
TIRETRACK_API_TOKEN = "${TIRETRACK_API_TOKEN}"

Gemini CLI

Stable (production):

{
  "mcpServers": {
    "tiretrack": {
      "command": "uvx",
      "args": ["--refresh", "tiretrack-mcp"],
      "env": {
        "TIRETRACK_API_URL": "https://api.tiretrack.mi.tirerack.com",
        "TIRETRACK_API_TOKEN": "${TIRETRACK_API_TOKEN}"
      }
    }
  }
}

Dev (pre-release):

{
  "mcpServers": {
    "tiretrack": {
      "command": "uvx",
      "args": ["--refresh", "--prerelease", "allow", "tiretrack-mcp"],
      "env": {
        "TIRETRACK_API_URL": "https://api-dev.tiretrack.mi.tirerack.com",
        "TIRETRACK_API_TOKEN": "${TIRETRACK_API_TOKEN}"
      }
    }
  }
}

Transports

Transport Command Use case
stdio (default) tiretrack-mcp Claude Code, Codex, Gemini CLI, Claude Desktop
Streamable HTTP tiretrack-mcp --transport streamable-http --port 8080 ChatGPT, remote clients
SSE (legacy) tiretrack-mcp --transport sse --port 8080 Older clients

Development

cd mcp-server
uv sync
uv run tiretrack-mcp --help

Metadata

Release files for tiretrack-mcp 0.2.18.dev20261105213738

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tiretrack-mcp 0.2.18.dev20261105213738
File Size Uploaded Provenance Actions
tiretrack_mcp-0.2.18.dev20261105213738.tar.gz 80.5 kB Without provenance Details for tiretrack_mcp-0.2.18.dev20261105213738.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tiretrack-mcp 0.2.18.dev20261105213738
File Interpreter ABI Platform Actions
tiretrack_mcp-0.2.18.dev20261105213738-py3-none-any.whl Python 3 none any Details for tiretrack_mcp-0.2.18.dev20261105213738-py3-none-any.whl

Total release size: 99.2 kB

Release files / tiretrack_mcp-0.2.18.dev20261105213738.tar.gz

Download URL tiretrack_mcp-0.2.18.dev20261105213738.tar.gz
Size 80.5 kB
Tags Source
SHA-256 checksum
How to use checksums
361df3538ce6d17e3c266027d4ad17b4f61cdc751721bf2dc3d473dc43d7da0c
BLAKE2b-256 checksum
How to use checksums
66b0e97fede119c2575639b84e7809789f5f58a9ae2ae6838803df4f506ac1b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / tiretrack_mcp-0.2.18.dev20261105213738-py3-none-any.whl

Download URL tiretrack_mcp-0.2.18.dev20261105213738-py3-none-any.whl
Size 18.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
63347d0a24cd9d0a4cd2623c7ebb11eeee2668ee02f96fd67618bc1b7a381008
BLAKE2b-256 checksum
How to use checksums
25898bc3df2b02abc55040f2f2ba4b8d68e84969ddab5740f9e5b44ab2040158
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for tiretrack-mcp 0.2.18.dev20261105213738

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page