tdf-fantasy-mcp 0.0.1

package/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    groups:
+      mcp-sdk:
+        patterns:
+          - "@modelcontextprotocol/*"
+      typescript-tooling:
+        patterns:
+          - "typescript"
+          - "ts-node"
+          - "@types/*"

package/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci
+
+      - name: Type-check
+        run: npx tsc --noEmit
+
+      - name: Build
+        run: npm run build

package/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish
+        run: npm publish --access public --provenance

package/.nvmrc

@@ -0,0 +1 @@
+20

package/CLAUDE.md

@@ -0,0 +1,174 @@
+# TdF Fantasy MCP — Claude Context
+
+## Purpose
+
+MCP server for the [Tour de France Fantasy game](https://fantasy.letour.fr) by Tissot.
+Exposes game data (riders, teams, stages, standings, leaderboards) and fantasy management
+actions as MCP tools, and provides 18 strategic prompts that combine fantasy game data
+with FirstCycling historical stats for richer analysis.
+
+---
+
+## API
+
+**Base URL:** `https://fantasybytissot.letour.fr/v1`
+
+**Required header on every request:**
+```
+X-Access-Key: 630@16.17@
+```
+Format: `{identity}@{version}@{codeDemo}` — identity `630` is Tour de France, version `16.17`.
+
+**Private endpoints additionally require:**
+```
+Authorization: Token {jwt}
+```
+The JWT comes from logging in at fantasy.letour.fr. Set it via the `TDF_AUTH_TOKEN` environment variable. If the variable is present, the server includes it on public endpoints too (no harm done).
+
+**Off-season behaviour:** Between editions (outside roughly June–July), the game enters maintenance mode. Most `/private/` endpoints return `{"message": "Jeu en cours de mise à jour"}`. The `/public/config.json` endpoint stays live year-round and is the main signal that the API is reachable.
+
+---
+
+## Build & Run
+
+**Node 18+ required** — the server uses native `fetch` (not available in Node 16).
+
+```bash
+npm install
+npm run build      # tsc → dist/
+npm start          # node dist/index.js
+npm run dev        # ts-node src/index.ts (no build step)
+```
+
+Entry point: `dist/index.js`
+Transport: stdio (MCP standard)
+
+Key dependency: `@modelcontextprotocol/sdk` (requires Node ≥ 18).
+
+---
+
+## Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "tdf-fantasy": {
+      "command": "node",
+      "args": ["/path/to/tdf-fantasy-mcp/dist/index.js"],
+      "env": {
+        "TDF_AUTH_TOKEN": "your_jwt_token_here"
+      }
+    }
+  }
+}
+```
+
+Run `nvm use` in the project directory first (picks up `.nvmrc` → Node 24 LTS), then `node` resolves correctly.
+
+---
+
+## Tools (18 total)
+
+### Public — no auth required
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `get_game_config` | `GET /public/config.json` | Full game config: budget, team size, positions, rules |
+| `get_riders` | `GET /public/sportifs` | All riders with names, teams, prices, positions |
+| `get_teams` | `GET /public/clubs` | All professional cycling teams |
+
+### Stages — auth required
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `get_current_stage` | `GET /private/journee` | Current stage info and results |
+| `get_stage` | `GET /private/journee/{n}` | Specific stage by number |
+| `get_stage_calendar` | `GET /private/journeecalendrier/{n}` | Stage schedule/calendar |
+
+### Standings — auth required
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `get_general_standings` | `GET /private/classementgeneral/{groupId}` | Overall fantasy leaderboard |
+| `get_stage_standings` | `GET /private/classementjournee/{groupId}/{n}` | Per-stage leaderboard |
+| `get_player_progression` | `GET /private/progressionjoueur/{groupId}/{n}` | Points across stages |
+| `get_hall_of_fame` | `GET /private/halloffame` | All-time top performers |
+
+### Leagues — auth required
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `get_my_leagues` | `GET /private/mesgroupes` | Leagues the user belongs to |
+| `get_league` | `GET /private/infosgroupe/{groupId}` | Details about a specific league |
+| `search_leagues` | `POST /private/groupessearch` | Search leagues by name or code |
+
+### User & Stats — auth required
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `get_rider_stats` | `POST /private/stats` | Rider stats with optional filters |
+| `get_top_transactions` | `GET /private/toptransaction` | Most bought/sold riders |
+| `get_user_profile` | `GET /private/joueur/{id}` | User fantasy profile |
+| `get_rider_positions` | `GET /private/positions` | Position type definitions |
+| `get_notifications` | `GET /private/notification` | User notifications |
+| `get_user_credits` | `GET /private/usercredits` | Credit balance |
+
+---
+
+## Prompts (18 total)
+
+All prompts follow a **two-phase pattern**:
+
+1. **Fantasy data phase** — fetch game data (riders, prices, stages, team) using the tdf-fantasy tools above
+2. **FirstCycling enrichment phase** — look up relevant riders on the `firstcycling-mcp` server for historical palmares, terrain-specific performance, and recent form before making any recommendation
+
+The user is expected to have `firstcycling-mcp` installed alongside this server. Prompts reference "FirstCycling tools" generically so Claude resolves them at runtime.
+
+### Team Building
+
+| Prompt | Arguments | Description |
+|--------|-----------|-------------|
+| `strongest_team` | `budget` (req), `strategy` (req: gc/climber/sprinter/puncher/breakaway) | Strongest 8-rider team; validates picks against FirstCycling palmares |
+| `best_value_picks` | `max_price` (req), `specialty` (opt) | Best value under price cap; enriches with FirstCycling form/terrain fit |
+| `design_specialty_team` | `specialty` (req), `budget` (req) | Full team around one specialty; FirstCycling validates track record |
+| `go_all_in_breakaways` | `budget` (req) | Aggressive breakaway stack; FirstCycling verifies actual breakaway history |
+
+### Exchange Planning
+
+| Prompt | Arguments | Description |
+|--------|-----------|-------------|
+| `plan_transfers` | `stages_ahead` (req), `exchanges_remaining` (req) | Optimal transfer plan; matches stage terrain against FirstCycling terrain specialties |
+| `who_to_drop_before_stage` | `stage_number` (req) | Drop candidates before a stage |
+| `replacement_for_abandoned_rider` | `abandoned_rider_name` (req), `budget` (req) | Replacement after a DNF |
+| `final_week_strategy` | `exchanges_remaining` (req) | Final week transfer plan |
+
+### Team Analysis
+
+| Prompt | Arguments | Description |
+|--------|-----------|-------------|
+| `analyze_team_form` | none | Team form + FirstCycling recent results to separate bad form from bad luck |
+| `who_is_underperforming` | none | Underperformers; FirstCycling distinguishes fading form vs. due a result |
+| `flag_injury_risks` | none | Injury/fatigue flags; FirstCycling recent results spot pre-Tour injury patterns |
+| `close_gap_on_rival` | `rival_name` (req) | Gap-closing strategy; FirstCycling terrain fit compared across both teams |
+
+### Preference-Personalised
+
+| Prompt | Arguments | Description |
+|--------|-----------|-------------|
+| `team_around_nationality` | `nationality` (req), `budget` (req) | Nationality-anchored team; FirstCycling ranks candidates by palmares |
+| `team_around_pro_team` | `pro_team_name` (req), `budget` (req) | Pro-team-anchored fantasy team |
+| `find_riders_like_favorite` | `favorite_rider_name` (req) | Similar riders; FirstCycling profile match drives similarity |
+| `specialty_first_team` | `specialty` (req), `budget` (req), `preferred_nationality` (opt) | Specialty-first with optional nationality tie-break |
+| `scout_riders_from_country` | `nationality` (req), `max_price` (req) | Scout a country's riders; FirstCycling palmares is the primary ranking signal |
+| `preferred_riders_value_check` | `rider_names` (req, comma-sep), `budget` (req) | Value check on a personal watchlist |
+
+---
+
+## Rider Position IDs
+
+| ID | Label | Description |
+|----|-------|-------------|
+| 43 | Leaders | GC contenders |
+| 44 | Polyvalents | All-rounders |
+| 45 | Grimpeurs | Climbers |
+| 46 | Sprinteurs | Sprinters |

package/INDEX.md

@@ -0,0 +1,111 @@
+# Codebase Index
+
+## File Tree
+
+```
+tdf-fantasy-mcp/
+├── src/
+│   └── index.ts          # Entire server: API helpers, tools, prompts, MCP wiring
+├── dist/                 # Compiled output (git-ignored); generated by `npm run build`
+│   └── index.js          # Entry point for production/Claude Desktop
+├── CLAUDE.md             # Context for Claude Code sessions — API, tools, prompts reference
+├── INDEX.md              # This file
+├── README.md             # User-facing docs: setup, tools table, WVA tribute
+├── package.json          # Dependencies, build/start/dev scripts, engines: node >=18
+├── package-lock.json     # Lockfile
+├── tsconfig.json         # target ES2020, commonjs, outDir dist/, rootDir src/
+└── .gitignore            # Ignores node_modules/, dist/, .env
+```
+
+---
+
+## src/index.ts — Layout
+
+The entire implementation lives in one file (~1100 lines). Sections in order:
+
+### Imports (lines 1–9)
+```
+@modelcontextprotocol/sdk/server/index.js   — Server class
+@modelcontextprotocol/sdk/server/stdio.js   — StdioServerTransport
+@modelcontextprotocol/sdk/types.js          — schemas, Tool, Prompt types
+```
+
+### API constants & helpers (lines 11–78)
+| Symbol | Purpose |
+|--------|---------|
+| `API_BASE` | `https://fantasybytissot.letour.fr/v1` |
+| `GAME_IDENTITY` / `GAME_VERSION` | `630` / `16.17` — baked into `X-Access-Key` |
+| `ACCESS_KEY` | `630@16.17@` — sent on every request |
+| `getAuthToken()` | Reads `TDF_AUTH_TOKEN` env var |
+| `buildHeaders(requiresAuth)` | Assembles headers; throws if auth required but token absent |
+| `apiGet(path, requiresAuth)` | Authenticated GET → parsed JSON |
+| `apiPost(path, body, requiresAuth)` | Authenticated POST → parsed JSON |
+
+### Tool definitions — `TOOLS` array (lines 80–329)
+18 `Tool` objects with `name`, `description`, and `inputSchema`. Grouped as:
+- Public: `get_game_config`, `get_riders`, `get_teams`
+- Stages: `get_current_stage`, `get_stage`, `get_stage_calendar`
+- Standings: `get_general_standings`, `get_stage_standings`, `get_player_progression`, `get_hall_of_fame`
+- Leagues: `get_my_leagues`, `get_league`, `search_leagues`
+- User/Stats: `get_rider_stats`, `get_top_transactions`, `get_user_profile`, `get_rider_positions`, `get_notifications`, `get_user_credits`
+
+### Tool handler — `handleTool()` (lines 331–433)
+`switch` on tool name → calls `apiGet` or `apiPost`. One case per tool.
+
+### Prompt definitions — `PROMPTS` array (lines 435–703)
+18 `Prompt` objects with `name`, `description`, and `arguments` array.
+Each argument has `name`, `description`, and `required: boolean`.
+
+### Prompt helpers (lines 705–715)
+| Symbol | Purpose |
+|--------|---------|
+| `type Args` | `Record<string, string>` — the raw arguments map from MCP |
+| `req(args, key)` | Reads a required arg; throws with a clear message if missing |
+| `opt(args, key)` | Reads an optional arg; returns `undefined` if absent |
+
+### Prompt builder — `buildPromptText()` (lines 717–1023)
+`switch` on prompt name → returns an interpolated string ready to send as a user message.
+Each case calls `req()`/`opt()` for its arguments then builds the prompt text.
+The 11 FirstCycling-enriched prompts explicitly instruct Claude to use FirstCycling tools
+after fetching fantasy data.
+
+### MCP server wiring (lines 1025–1096)
+```
+new Server({ name, version }, { capabilities: { tools: {}, prompts: {} } })
+
+setRequestHandler(ListToolsRequestSchema)   → returns TOOLS
+setRequestHandler(ListPromptsRequestSchema) → returns PROMPTS
+setRequestHandler(GetPromptRequestSchema)   → calls buildPromptText(), wraps in message
+setRequestHandler(CallToolRequestSchema)    → calls handleTool(), wraps result as text
+```
+
+### Entry point — `main()` (lines 1087–1096)
+Connects a `StdioServerTransport` and logs `"TdF Fantasy MCP server running on stdio"` to stderr.
+
+---
+
+## Gotchas
+
+**`get_user_profile` with no `user_id`** calls `/private/joueur/me` — this endpoint may not
+exist on the real API (it was not in the discovered route list). If it 404s, the caller should
+pass an explicit user ID obtained from another endpoint (e.g. league standings).
+
+**Off-season responses** — most `/private/` endpoints return a 200 with body
+`{"message": "Jeu en cours de mise à jour"}` rather than a 4xx during maintenance. Tool
+handlers will return this message as valid JSON rather than throwing; callers should check for it.
+
+**`get_rider_stats` filter shape** — the POST body is `{ credentials: { positions, clubs, minPrice, maxPrice } }`.
+The API field names are `positions` (not `position_ids`) and `clubs` (not `team_ids`); the
+mapping happens in `handleTool`.
+
+**Node 18+ required** — `fetch` is not available in Node 16. The `@modelcontextprotocol/sdk`
+package also declares `engines: { node: ">=18" }`. Use `nvm use 18` or point Claude Desktop's
+`command` at the full Node 18 binary path.
+
+**Single-file architecture** — all tools, prompts, and server logic are in `src/index.ts`.
+If the file grows significantly, consider splitting into `src/tools.ts`, `src/prompts.ts`,
+and `src/api.ts` with a thin `src/index.ts` that wires them together.
+
+**FirstCycling tool names are not hardcoded** — prompt texts refer to "the FirstCycling tools"
+generically. Claude resolves them at runtime from whatever the `firstcycling-mcp` server
+exposes. This means prompts remain valid even if the firstcycling-mcp tool names change.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ken MacInnis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,164 @@
+# TdF Fantasy MCP
+
+An MCP (Model Context Protocol) server for the [Tour de France Fantasy game](https://fantasy.letour.fr) by Tissot.
+
+## Overview
+
+This server exposes the Tour de France Fantasy game API as MCP tools, letting you query riders, teams, stages, standings, and leaderboards from any MCP-compatible client (Claude Desktop, etc.).
+
+The underlying API lives at `https://fantasybytissot.letour.fr/v1`.
+
+## Requirements
+
+- **Node.js >= 20** — the server uses native `fetch`, which requires Node 18+ and is stable from Node 20 onward. Check your version with `node --version`; use [nvm](https://github.com/nvm-sh/nvm) to switch if needed.
+- **Recommended companion: [firstcycling-mcp](https://github.com/r-huijts/firstcycling-mcp)** — 11 of the 18 prompts follow a two-phase pattern that enriches fantasy recommendations with FirstCycling historical palmares and terrain data. The tools work without it, but the prompts produce noticeably better output when both servers are connected.
+- **Auth token** — public tools (`get_game_config`, `get_riders`, `get_teams`) work without authentication. All other tools require a valid JWT from the game. See [Authentication](#authentication) below.
+
+## Setup
+
+### Install
+
+```bash
+npm install
+npm run build
+```
+
+### Authentication
+
+Some tools require a valid auth token from the game. To obtain one:
+
+1. Open [fantasy.letour.fr](https://fantasy.letour.fr) in your browser
+2. Log in to your account
+3. Open DevTools → Network tab
+4. Make any in-game action and look for requests to `fantasybytissot.letour.fr/v1/private/`
+5. Copy the `Authorization` header value (everything after `Token `)
+
+Set it as an environment variable before running:
+
+```bash
+export TDF_AUTH_TOKEN="your_jwt_token_here"
+```
+
+Tools that don't require auth (`get_game_config`, `get_riders`, `get_teams`) work without a token.
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tdf-fantasy": {
+      "command": "node",
+      "args": ["/path/to/tdf-fantasy-mcp/dist/index.js"],
+      "env": {
+        "TDF_AUTH_TOKEN": "your_jwt_token_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Public (no auth required)
+
+| Tool | Description |
+|------|-------------|
+| `get_game_config` | Full game configuration: budget, team size, rider positions, rules |
+| `get_riders` | All riders with names, teams, prices, positions (active season only) |
+| `get_teams` | All professional cycling teams |
+
+### Private (auth required)
+
+| Tool | Description |
+|------|-------------|
+| `get_current_stage` | Current stage info and results |
+| `get_stage` | Specific stage info by number |
+| `get_stage_calendar` | Stage schedule/calendar |
+| `get_general_standings` | Overall fantasy leaderboard for a group |
+| `get_stage_standings` | Per-stage leaderboard for a group |
+| `get_my_leagues` | Your leagues/groups |
+| `get_league` | Details about a specific league |
+| `search_leagues` | Search for leagues by name or code |
+| `get_rider_stats` | Rider statistics with optional filters |
+| `get_top_transactions` | Most bought/sold riders |
+| `get_user_profile` | User fantasy profile and team |
+| `get_rider_positions` | Position type definitions |
+| `get_hall_of_fame` | All-time top performers |
+| `get_player_progression` | Point progression across stages |
+| `get_notifications` | Your game notifications |
+| `get_user_credits` | Your credit balance |
+
+## Rider Positions
+
+| ID | Name | Description |
+|----|------|-------------|
+| 43 | Leaders | GC contenders |
+| 44 | Polyvalents | All-rounders |
+| 45 | Grimpeurs | Climbers |
+| 46 | Sprinteurs | Sprinters |
+
+## Notes
+
+- The API goes into maintenance mode (`{"message": "Jeu en cours de mise à jour"}`) between editions of the Tour de France. Most private endpoints return this message off-season.
+- The game runs annually during the Tour de France (typically July).
+- Budget per team: 120M (standard), 160M (mercato mode)
+- Team size: 8 riders
+
+## Development
+
+```bash
+npm run dev    # Run with ts-node (no build step)
+npm run build  # Compile to dist/
+npm start      # Run compiled output
+```
+
+## Prompts
+
+The server exposes 18 MCP prompts that clients like Claude Desktop surface as slash commands or quick actions. Select a prompt, fill in the arguments, and Claude will call the relevant tools automatically.
+
+Prompts follow a **two-phase pattern**: first fetch live fantasy data (riders, prices, stage calendar, your team) using the tdf-fantasy tools, then enrich the analysis with [firstcycling-mcp](https://github.com/r-huijts/firstcycling-mcp) for historical palmares, recent form, and terrain-specific performance. Having both servers connected gives the best results.
+
+**Example — finding the best value climbers under 14 credits:**
+> Invoke `best_value_picks` with `max_price=14`, `specialty=climber`
+>
+> Claude fetches all affordable riders from the fantasy API, checks the upcoming mountain stage profiles, then looks each candidate up on FirstCycling to verify their climbing palmares and current form before ranking them.
+
+### Team Building
+
+| Prompt | Arguments | What it does |
+|--------|-----------|--------------|
+| `strongest_team` | `budget` (req), `strategy` (req: gc/climber/sprinter/puncher/breakaway) | Builds the strongest 8-rider team for your budget and strategy; validates picks against FirstCycling palmares |
+| `best_value_picks` | `max_price` (req), `specialty` (opt) | Finds best value-for-money riders under a price cap; enriches with FirstCycling form and terrain fit |
+| `design_specialty_team` | `specialty` (req), `budget` (req) | Designs a full team around one racing specialty; FirstCycling validates each rider's track record |
+| `go_all_in_breakaways` | `budget` (req) | Builds an aggressive breakaway-specialist team; FirstCycling verifies actual breakaway history |
+
+### Exchange Planning
+
+| Prompt | Arguments | What it does |
+|--------|-----------|--------------|
+| `plan_transfers` | `stages_ahead` (req), `exchanges_remaining` (req) | Plans optimal transfers for the next N stages; matches terrain against FirstCycling specialties before recommending swaps |
+| `who_to_drop_before_stage` | `stage_number` (req) | Identifies drop candidates before a specific stage with replacement suggestions |
+| `replacement_for_abandoned_rider` | `abandoned_rider_name` (req), `budget` (req) | Finds the best replacement after a key rider abandons |
+| `final_week_strategy` | `exchanges_remaining` (req) | Devises an end-of-Tour transfer plan for the mountain stages, TT, and Champs-Élysées |
+
+### Team Analysis
+
+| Prompt | Arguments | What it does |
+|--------|-----------|--------------|
+| `analyze_team_form` | none | Analyses your team's points trajectory; uses FirstCycling recent results to distinguish bad form from bad luck |
+| `who_is_underperforming` | none | Identifies underperformers relative to price; FirstCycling checks whether they're fading or due a result |
+| `flag_injury_risks` | none | Flags injury and fatigue risks; FirstCycling recent results spot pre-Tour patterns |
+| `close_gap_on_rival` | `rival_name` (req) | Plans a gap-closing strategy; compares both teams' riders via FirstCycling terrain fit for remaining stages |
+
+### Preference-Personalised
+
+| Prompt | Arguments | What it does |
+|--------|-----------|--------------|
+| `team_around_nationality` | `nationality` (req), `budget` (req) | Builds a team featuring as many riders of a given nationality as possible; ranked by FirstCycling palmares |
+| `team_around_pro_team` | `pro_team_name` (req), `budget` (req) | Anchors a fantasy team around riders from a specific professional team |
+| `find_riders_like_favorite` | `favorite_rider_name` (req) | Finds riders with a similar profile; FirstCycling career match drives the comparison |
+| `specialty_first_team` | `specialty` (req), `budget` (req), `preferred_nationality` (opt) | Builds a specialty-first team with an optional nationality tie-break |
+| `scout_riders_from_country` | `nationality` (req), `max_price` (req) | Scouts a country's riders under a price cap; FirstCycling palmares is the primary ranking signal |
+| `preferred_riders_value_check` | `rider_names` (req, comma-separated), `budget` (req) | Checks whether a personal watchlist fits within budget and at good value |

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}