{
  "markdown": "# @racehooks/mcp\n\nMCP server for [RaceHooks](https://racehooks.io) — gives AI assistants (Claude, Cursor, Windsurf) direct access to RaceHooks motorsport analytics and data.\n\n[![npm](https://img.shields.io/npm/v/@racehooks/mcp)](https://www.npmjs.com/package/@racehooks/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n> RaceHooks is an independent service and is not affiliated with or endorsed by Formula One Management or the FIA. \"Formula 1,\" \"F1,\" and related marks are trademarks of Formula One Licensing BV.\n\n## What this does\n\nExposes your [RaceHooks](https://racehooks.io) account as a set of tools and resources an AI assistant can call:\n\n**Tools (actions):**\n- `list_feeds` / `list_webhooks` / `get_webhook` / `create_webhook` / `delete_webhook`\n- `test_webhook` / `get_webhook_logs`\n- `get_live_session` / `list_events`\n- `get_subscription` / `get_usage` / `get_usage_by_feed` / `get_billing_plan`\n- `start_simulation` / `list_simulations` / `get_simulation` / `cancel_simulation`\n\n**Resources (read-only context):**\n- `racehooks://feeds` — full [feed catalog](https://racehooks.io/docs/feeds)\n- `racehooks://live` — current live session state\n- `racehooks://webhooks` — all webhook subscriptions\n- `racehooks://usage` — current delivery usage\n\n**Prompts (guided workflows):**\n- `setup_race_event_webhook` — create an `events.race` subscription with filters\n- `setup_fantasy_scoring_webhook` — create a fantasy-optimised subscription\n- `check_account_health` — full account health summary\n\n## Installation\n\n```bash\nnpm install -g @racehooks/mcp\n```\n\nOr run directly with npx:\n\n```bash\nnpx @racehooks/mcp\n```\n\nGet your API credentials at [racehooks.io](https://racehooks.io).\n\n## Configuration\n\nSet two environment variables before starting:\n\n```bash\nexport RACEHOOKS_CLIENT_ID=\"your-client-id\"\nexport RACEHOOKS_CLIENT_SECRET=\"your-client-secret\"\n# Optional — defaults to https://api.racehooks.io\nexport RACEHOOKS_BASE_URL=\"https://api.racehooks.io\"\n```\n\n## Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"racehooks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@racehooks/mcp\"],\n      \"env\": {\n        \"RACEHOOKS_CLIENT_ID\": \"your-client-id\",\n        \"RACEHOOKS_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Claude Code (project config)\n\nAdd to `.claude/settings.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"racehooks\": {\n      \"type\": \"stdio\",\n      \"command\": \"racehooks-mcp\",\n      \"env\": {\n        \"RACEHOOKS_CLIENT_ID\": \"your-client-id\",\n        \"RACEHOOKS_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\nOr with npx (no global install needed):\n\n```json\n{\n  \"mcpServers\": {\n    \"racehooks\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@racehooks/mcp\"],\n      \"env\": {\n        \"RACEHOOKS_CLIENT_ID\": \"your-client-id\",\n        \"RACEHOOKS_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Cursor / Windsurf\n\nAdd to your MCP config (`.cursor/mcp.json` or equivalent):\n\n```json\n{\n  \"mcpServers\": {\n    \"racehooks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@racehooks/mcp\"],\n      \"env\": {\n        \"RACEHOOKS_CLIENT_ID\": \"your-client-id\",\n        \"RACEHOOKS_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Example usage with Claude\n\nOnce configured, you can ask Claude things like:\n\n> \"Check my RaceHooks account health\"\n\n> \"Create an `events.race` webhook for https://myapp.com/hook, filtering for Ferrari only\"\n\n> \"Start a simulation of the 2025 Monaco GP qualifying against my webhooks at 10× speed\"\n\n> \"Show me which feeds are using the most delivery quota today\"\n\n> \"Set up a fantasy scoring webhook for my VER, NOR, LEC team at https://scoring.myapp.com/hook\"\n\n## Security\n\nThe MCP server runs as a local stdio process — it never binds a network port. Your credentials are passed via environment variables, not included in tool calls or resource URIs.\n\nAll API calls are authenticated using OAuth 2 client credentials (token auto-refreshes before expiry).\n\n## Links\n\n- [RaceHooks console](https://racehooks.io/console) — sign up and manage your account\n- [RaceHooks API documentation](https://racehooks.io/docs)\n- [Webhook API reference](https://racehooks.io/docs/webhooks)\n- [Feed catalog](https://racehooks.io/docs/feeds)\n- [GitHub](https://github.com/racehooks/racehooks-mcp)\n- [npm](https://www.npmjs.com/package/@racehooks/mcp)\n- [Smithery listing](https://smithery.ai/server/racehooks-mcp)\n- [MCP specification](https://modelcontextprotocol.io)\n",
  "bytes": 4594,
  "sha": "8bb9c315f73ca809bd18886cea6308e21c27cd8475b299aed4cb29aa7d861996",
  "repo_slug": "racehooks/racehooks-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_racehooks_racehooks_mcp_7890ba14/readme"
}