# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
cd targetprocess-mcp
uv sync

# Using CLI (recommended)
claude mcp add targetprocess --transport stdio --scope user -- python -m targetprocess_mcp.server

{
  "mcpServers": {
    "targetprocess": {
      "command": "python",
      "args": ["-m", "targetprocess_mcp.server"]
    }
  }
}

configure(url="https://yourcompany.tpondemand.com", token="your-api-token")

configure(
    url: str,                    # TargetProcess URL
    token: str,                  # API token
    vpn_required: bool = false,  # Require VPN connection
    vpn_check_hosts: str = None  # Comma-separated hosts to check
)

configure(url="https://mycompany.tpondemand.com", token="abc123")

# Returns: [{"id": 1, "name": "My Project"}, ...]
get_projects(take: int = 100)

search(
    query: str,              # Search term
    entity_type: str = None, # UserStory, Bug, Feature, or Task
    project_id: int = None, # Filter by project
    take: int = 20           # Max results
)

get_user_stories(
    project_id: int = None,   # Filter by project
    feature_id: int = None,   # Filter by feature
    assignee_id: int = None, # Filter by assignee
    state: str = None,        # e.g., "Open", "In Progress", "Done"
    take: int = 100
)

get_bugs(
    project_id: int = None,   # Filter by project
    assignee_id: int = None, # Filter by assignee
    state: str = None,        # e.g., "Open", "Resolved", "Done"
    severity: str = None,    # e.g., "Critical", "Major", "Minor"
    take: int = 100
)

get_features(
    project_id: int = None, # Filter by project
    state: str = None,       # e.g., "Proposed", "In Progress"
    take: int = 100
)

get_sprints(
    project_id: int = None, # Filter by project
    take: int = 50
)

Get all open bugs in project 5

Search for user stories named "login"

Get all features for project 3

Show me the sprints for project "MyApp"

Configure TargetProcess with my account (url)
Show me my TargetProcess status

What projects do I have access to?
Find projects named "Mobile"
Search for user stories about login
Find bugs tagged as critical

Show my open user stories
Get all user stories for project 5
List user stories assigned to me that are in progress
Show me user stories for feature 123

Show me all open bugs
What critical bugs exist in project 3?
List bugs assigned to me
Show bugs in QA state for review

What features are in progress?
Show completed features for project "Website Redesign"

What sprints are coming up?
Show me the current sprint for project 5
List all releases for project "Mobile App"

vpn_required: true
vpn_check_hosts: internal-api.company.com

configure(url="https://yourcompany.tpondemand.com", token="new-token")
configure(url="https://yourcompany.tpondemand.com", token="token", vpn_required=true, vpn_check_hosts="host1,host2")

~/.config/targetprocess-mcp/config.toml

URL = "https://yourcompany.tpondemand.com"

VPN_REQUIRED = true
VPN_CHECK_HOSTS = ["internal-api.company.com"]

configure(url="https://yourcompany.tpondemand.com", token="your-api-token")

claude mcp list

# Add token
security add-generic-password -s targetprocess-mcp -a api-token -w YOUR_TOKEN

# Delete token
security delete-generic-password -s targetprocess-mcp -a api-token

targetprocess_mcp/
├── __init__.py          # Package metadata
├── config.py            # Configuration & Keychain
├── client.py            # TargetProcess API client
├── server.py            # FastMCP server & tools
├── models/              # Dataclass models
│   ├── __init__.py
│   ├── project.py
│   ├── user_story.py
│   └── ...
├── pyproject.toml       # Package configuration
└── .pre-commit-config.yaml

uv run pytest tests/

# Run ruff linter
uv run ruff check targetprocess_mcp/

# Run mypy type checker
uv run mypy targetprocess_mcp/

# Install pre-commit
pip install pre-commit

# Install hooks
pre-commit install

# Run manually anytime
pre-commit run --all-files