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
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.15.dev20261027150521

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.15.dev20261027150521
File Size Uploaded Provenance Actions
tiretrack_mcp-0.2.15.dev20261027150521.tar.gz 77.2 kB Without provenance Details for tiretrack_mcp-0.2.15.dev20261027150521.tar.gz

Built distribution (wheel)

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

Total release size: 94.2 kB

Release files / tiretrack_mcp-0.2.15.dev20261027150521.tar.gz

Download URL tiretrack_mcp-0.2.15.dev20261027150521.tar.gz
Size 77.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1aeaca3d284244b444c2482f34687011d81b116c02c5d0eae7a291f0e0d9f90e
BLAKE2b-256 checksum
How to use checksums
185bdf3be31c0737cd1df26cd991d53b0fa76f53dd3e672a6ceb5aa0bfb9c66a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.15.dev20261027150521-py3-none-any.whl

Download URL tiretrack_mcp-0.2.15.dev20261027150521-py3-none-any.whl
Size 17.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d98b676ce1374be4131c3de51cd89eea7782fbd8595ae015cb500422ed50b109
BLAKE2b-256 checksum
How to use checksums
3ff1a76c6a067969935d6a59fecf2cf5bde048aefa4dc7a745abb2b43eb2eac8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.15.dev20261027150521

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