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.17.dev20261104210045

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.17.dev20261104210045
File Size Uploaded Provenance Actions
tiretrack_mcp-0.2.17.dev20261104210045.tar.gz 80.5 kB Without provenance Details for tiretrack_mcp-0.2.17.dev20261104210045.tar.gz

Built distribution (wheel)

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

Total release size: 99.2 kB

Release files / tiretrack_mcp-0.2.17.dev20261104210045.tar.gz

Download URL tiretrack_mcp-0.2.17.dev20261104210045.tar.gz
Size 80.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b7ca9504e621f52f5438cce90681b9a624eb41aaa8d97f3187ccb64ffe5f16f6
BLAKE2b-256 checksum
How to use checksums
9d1c0057cac3d8c35bee6c8e1a25c0fdb7d29a424e3421cf7baf9432365e43d7
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.17.dev20261104210045-py3-none-any.whl

Download URL tiretrack_mcp-0.2.17.dev20261104210045-py3-none-any.whl
Size 18.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b0ec23c28d4f27c21ed2a264efa88c8b24691e1b98c2d36e04d57eb4bf097171
BLAKE2b-256 checksum
How to use checksums
4a08443144d401b0e4c51633f80b729e22dd9104549bc414b502ed248bb9f2e5
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.17.dev20261104210045

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