Skip to main content

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

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

Built distribution (wheel)

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

Total release size: 99.0 kB

Release files / tiretrack_mcp-0.2.18.tar.gz

Download URL tiretrack_mcp-0.2.18.tar.gz
Size 80.5 kB
Tags Source
SHA-256 checksum
How to use checksums
6d3ab5a013077956d38d7fae73d2c50aba085745ae2cdedd9041edc35eb3a5a2
BLAKE2b-256 checksum
How to use checksums
62723b251b66f75716f7bbde4ccedd1fdd594515cd05bde6e7dc3f6b57a3e75d
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-py3-none-any.whl

Download URL tiretrack_mcp-0.2.18-py3-none-any.whl
Size 18.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
196a2fe63f82a7dc69987e0f95f706de6940de1dc6f84f2d1cdf13e7d5420a9e
BLAKE2b-256 checksum
How to use checksums
46c0d747ef2bca64e7b0597b04c2c7b3a58be140e5eec7dda05cca364ca8988c
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

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

This release

0.2.18 This release

2 release files No provenance

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