How to Use the NHL MCP in Claude Code

Q: How do I connect Claude Code to the NHL MCP Server?

Run the claude mcp add command in your terminal and pass the Vinkius URL with the --transport http flag. The CLI updates your /.claude.json file and registers all 47 hockey tools instantly.

Q: Does Claude Code format the NHL JSON responses?

The agent reads the raw JSON from tools like getgameboxscore and formats it based on your prompt. You can tell it to output a plain text summary or pipe it into jq for further processing.

Q: Can I track live hockey games from the command line?

You sure can. Claude Code can poll getlivescores and getgameplaybyplay to print real-time updates directly to your standard output. It is the fastest way to monitor a game while you work.

Pipe live hockey scores and advanced player metrics directly into your terminal with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NHL MCP to Claude Code

Create your Vinkius account to connect NHL to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup NHL with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Pipelines with Claude Code

The NHL MCP Server pushes live sports data straight into your terminal. You can configure Claude Code to run `get_live_scores` on a cron job, piping the active game states into a local Redis cache. The CLI handles the HTTP requests and formats the output without you ever opening a browser. The `get_team_weekly_schedule` tool finds upcoming matchups to build a schedule alerter. Your agent queries this endpoint and `get_current_schedule` to grab start times. It parses those timestamps and triggers a shell script to send you a Slack notification before puck drop.

Headless NHL Stat Aggregation

The `get_skater_powerplay` tool pulls structured JSON straight from the league into your command line. Pulling player metrics from the terminal is usually a mess. You ask for the top powerplay producers, and the agent filters the raw data right in your window using this and `get_goalie_advanced`. The `get_team_summary` tool generates daily markdown reports of team analytics. The CLI triggers this alongside `get_team_faceoff_percentages` to build out the stats. It runs the tools, formats the tables, and saves the file to your local directory.

Query Historic Milestones via MCP Server

The `get_records_milestone_1000_point` tool grabs career achievement data for automated workflows. Claude Code executes this to pull decades of history. It takes that array and writes it directly to your PostgreSQL database using a quick bash script. The `get_records_franchise_team_totals` tool dumps raw franchise stats into a CSV file. Your terminal agent calls this and `get_records_attendance` to format the data. Your data science team gets clean records so they can start building predictive models immediately.

Setup guide

Set up NHL MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see nhl-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest NHL transactions." It will automatically discover and invoke the available NHL tools.

Terminal

claude mcp add --transport http nhl-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the NHL MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "nhl-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by NHL. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect NHL now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about NHL MCP in Claude Code

Run the `claude mcp add` command in your terminal and pass the Vinkius URL with the `--transport http` flag. The CLI updates your `~/.claude.json` file and registers all 47 hockey tools instantly.

Yes. You can run Claude Code in any headless environment. Set it up to call `get_current_standings` every night and automatically commit a markdown standings update to your repository.

The agent reads the raw JSON from tools like `get_game_boxscore` and formats it based on your prompt. You can tell it to output a plain text summary or pipe it into `jq` for further processing.

You sure can. Claude Code can poll `get_live_scores` and `get_game_play_by_play` to print real-time updates directly to your standard output. It is the fastest way to monitor a game while you work.

The MCP endpoint only processes incoming requests for public sports statistics like player bios and game scores. Your local terminal environment variables and file system contents are never transmitted to the external API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript