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
Using uvx (recommended)
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 theTIRETRACK_API_TOKENfield 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}"
}
}
}
}
--refreshchecks PyPI for newer versions on each invocation.--prerelease allowinstalls.devpre-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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tiretrack_mcp-0.2.5.dev20260706173752.tar.gz.
File metadata
- Download URL: tiretrack_mcp-0.2.5.dev20260706173752.tar.gz
- Upload date:
- Size: 71.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6407b2494e1c45db53060cefd06d53efca5c4f1b3174980ea744bc88b773d2b4
|
|
| MD5 |
a4d4cc4dbf1b900a5b9ecd18e6397973
|
|
| BLAKE2b-256 |
b9db2330bfb28083b4fe3c4efb1585671730bfb712707b8629692c4189e463e2
|
File details
Details for the file tiretrack_mcp-0.2.5.dev20260706173752-py3-none-any.whl.
File metadata
- Download URL: tiretrack_mcp-0.2.5.dev20260706173752-py3-none-any.whl
- Upload date:
- Size: 14.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a8c79bfceb3863ed6ffedcb878a1dde30a88bd9690c973be7fa726056b26c299
|
|
| MD5 |
c0dcd18677ffaa1cb6348b4e71d50738
|
|
| BLAKE2b-256 |
6a42ef75db5e7df01d77637cd2c85d45ccd5f5bfd9c6e66e90e667ea7af6ffbd
|
