# IPSC Scoreboard

Analyze IPSC competition data and results from Shoot-n-Score-It to track shooter performance. Compare competitors stage-by-stage using detailed metrics like hit factors, time-vs-accuracy breakdowns, …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mandakan/ssi-scoreboard

# Browse available tools
npx -y @smithery/cli@latest tool list mandakan/ssi-scoreboard

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mandakan/ssi-scoreboard search_events

# Call a tool
npx -y @smithery/cli@latest tool call mandakan/ssi-scoreboard search_events '{}'
```

## Direct MCP Connection

Endpoint: `https://ssi-scoreboard--mandakan.run.tools`

**Optional config:**
- `baseUrl` (query) — Base URL of the SSI Scoreboard instance. Defaults to https://scoreboard.urdr.dev

## Tools (4)

- `search_events` — Search for IPSC competitions by name, country, date range, or level. Use this to find a specific match the user has nam…
- `get_match` — Fetch full details for a specific IPSC match. Returns the complete competitor list — each entry has a numeric `id`, `na…
- `compare_competitors` — Run a deep stage-by-stage comparison for 1–12 competitors in a match. Returns scores, hit factors, penalties, efficienc…
- `get_popular_matches` — List recently-viewed IPSC matches from the cache. Call this first whenever the user hasn't specified a match — it surfa…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mandakan/ssi-scoreboard <tool-name>
```

## Resources

- `ssi://guide` — How to use the SSI Scoreboard MCP tools, including workflows and data quality notes
- `ssi://ipsc-reference` — IPSC reference: divisions, match levels, status codes, scoring zones, hit factor formula, and shooter archetypes

## Prompts (3)

- `analyze_performance` (match_name, competitor_name) — Analyse a competitor's stage-by-stage performance at an IPSC match and produce coaching feedback
- `compare_squad` (match_name, squad) — Compare all members of a squad (or a named group) head-to-head at an IPSC match
- `find_matches` (query, country, level) — Find upcoming or recent IPSC matches, optionally filtered by country, name, or competition level