Boatrace Open API MCP Server

A Model Context Protocol (MCP) server providing access to official Boatrace race data through three core tools.

Overview

This MCP server enables Claude and other AI models to access Boatrace race information through the official Boatrace Open API. Three tools provide access to:

• programs: Race program data (出走表) - racer lineups, race conditions, odds
• results: Race results (結果) - winners, payouts, race statistics
• previews: Race previews (直前情報) - updated odds, predictions, analysis

Prerequisites

• Go 1.21 or later
• Access to Boatrace Open API (https://boatraceopenapi.github.io/)

Installation

From Source

git clone https://github.com/boatrace/open-api-mcp-server.git
cd boatrace-open-api-mcp-server
go mod download
make build

The binary will be created at bin/boatrace-mcp.

Usage

Starting the Server

./bin/boatrace-mcp

The server will start listening for MCP calls.

Using the Tools

programs - Fetch Race Programs

programs(year="2025", date="20251222")

Returns complete race program for the specified date including:

• Race lineup with racer numbers and names
• Race conditions (distance, weather)
• Betting odds and favorites
• Race metadata

results - Fetch Race Results

results(year="2025", date="20251220")

Returns race results for completed races including:

• Winning racer information
• Payouts (win, place, show)
• Race statistics and timing
• Payout details

previews - Fetch Race Previews

previews(year="2025", date="20251222")

Returns pre-race analysis and information including:

• Updated odds
• Expert predictions
• Race analysis
• Late-breaking news

IDE & CLI Integration

Claude Code

Quick Installation with claude mcp add

The fastest way to install this MCP server in Claude Code:

1. Build the server first:

   cd /path/to/boatrace-open-api-mcp-server
   make build
   

2. Add to Claude Code using claude mcp add command:

   For local development (project scope):

   claude mcp add --scope project --transport stdio boatrace-api -- \
     /path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp
   

   For user-wide installation (all projects):

   claude mcp add --scope user --transport stdio boatrace-api -- \
     /path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp
   

3. Verify installation:

   # List all installed MCP servers
   claude mcp list
   
   # Get details about boatrace-api server
   claude mcp get boatrace-api
   

4. Use in Claude Code: The tools will be automatically available:

   • programs(year="2025", date="20251222") - Get race programs
   • results(year="2025", date="20251220") - Get race results
   • previews(year="2025", date="20251222") - Get race previews

Manual Configuration (Alternative)

If you prefer manual configuration, add to .mcp.json in your project:

{
  "mcpServers": {
    "boatrace-api": {
      "type": "stdio",
      "command": "/path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp"
    }
  }
}

Or add to ~/.claude.json for user-wide configuration:

{
  "mcpServers": {
    "boatrace-api": {
      "type": "stdio",
      "command": "/path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp"
    }
  }
}

Troubleshooting

Server not appearing in Claude Code?

1. Check installation:

   claude mcp list
   

2. Verify binary exists and is executable:

   ls -la /path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp
   chmod +x /path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp
   

3. Test binary directly:

   /path/to/boatrace-open-api-mcp-server/bin/boatrace-mcp
   

4. Reload Claude Code or run /mcp command to refresh MCP server list

GitHub Copilot

To use this MCP server with GitHub Copilot (when MCP support is available):

1. **Build and locate the bin

... View full README on GitHub