{"id":7070,"plugin_id":"plugin_asdk_app_6a736fa1def48191af5a8f0c9cf88d4f","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:49:46.680Z","digest":"b9157ad1d6317a74136998cbec467b1cf1a413d6109bd96620e3b9f1d07b3d1f","against":null,"payload":{"name":"statshawk-mcp","description":"Drive the StatsHawk hosted MCP server during an agent session —\nwhich tool to call, how to chain ids, and how to recover from OAuth\nor quota failures.","included_files":[],"skill_md_contents":"---\nname: statshawk-mcp\ndescription: |\n  Drive the StatsHawk hosted MCP server during an agent session —\n  which tool to call, how to chain ids, and how to recover from OAuth\n  or quota failures.\n---\n\n# StatsHawk MCP (data tools)\n\nEndpoint: `https://mcp.statshawk.ai/mcp` (Streamable HTTP, OAuth)\n\n## When to use\n\nUse this skill when the agent itself needs sports data **right now**.\nFor product-code integration, switch to\n[`../build/SKILL.md`](https://statshawk.ai/agent-onboarding/build/SKILL.md).\nFor finished artifacts, switch to\n[`../workflows/SKILL.md`](https://statshawk.ai/agent-onboarding/workflows/SKILL.md).\n\n## Install (if missing)\n\n```bash\nclaude mcp add --transport http statshawk https://mcp.statshawk.ai/mcp\n```\n\nOther clients: https://statshawk.ai/docs/mcp/client-setup\n\nOn first tool call the client opens OAuth. The human signs in once; no\nAPI key is pasted into MCP config.\n\n## Tool routing\n\n| Need | Tool | Notes |\n| --- | --- | --- |\n| Find a player | `search_player` | Returns `person_id` for chaining |\n| Find games | `search_games` | Filter by league, date, team, status |\n| Box score | `get_box_score` | Needs a game / contest id |\n| Standings | `get_standings` | League slug e.g. `nba` |\n| Roster | `get_team_roster` | Current roster + person ids |\n| MLB matchups | `get_mlb_matchups` | Pregame pitching / lineup context |\n| MLB PBP / Statcast | `get_play_by_play` | Filterable per player |\n| Prop card / hit rates | `get_player_props` | **Paid plan** |\n| What can I ask? | `get_stat_capabilities` / `search_docs` | When unsure |\n\nFull catalog: https://statshawk.ai/docs/mcp/tool-catalog.md\n\n## Default flow\n\n1. **Discover** with `search_player` or `search_games`\n2. **Fetch** with the returned ids (`person_id`, contest/game ids)\n3. **Analyze** with `get_player_props` only when the account is paid\n4. **Cite** ids in the answer so the human can verify\n\n## Failure recovery\n\n- **OAuth window never appeared** — look for a queued sign-in prompt; or\n  remove and re-add the MCP server\n- **`403 TIER_REQUIRES_PAID`** — analysis tools need any paid plan; use\n  game logs / free tools instead, or ask the human to upgrade\n- **`429 QUOTA_EXCEEDED`** — monthly units exhausted; tell the human to\n  check https://statshawk.ai/dashboard\n- **Connected but empty** — confirm league slug and date window; offseason\n  standings still resolve to a concrete `season_year`\n\n## Auth & quotas\n\nhttps://statshawk.ai/docs/mcp/auth-and-quotas.md\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}