@davincibets/mcp-server

Da Vinci Bets MCP Server

Give your AI assistant native access to AI-powered sports predictions.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Quick Start

1. Get your API key

Go to davincibets.io/settings → API tab → Generate Key.

Your key looks like: dvb_live_a3f2... — copy it immediately (shown once).

2. Add to your AI assistant

Claude Desktop

Edit ~/.config/Claude/claude_desktop_config.json (Mac/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "davinci-bets": {
      "command": "npx",
      "args": ["-y", "@davincibets/mcp-server@latest"],
      "env": {
        "DVB_API_KEY": "dvb_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add davinci-bets -- npx -y @davincibets/mcp-server@latest

Then set the environment variable:

export DVB_API_KEY="dvb_live_your_key_here"

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "davinci-bets": {
      "command": "npx",
      "args": ["-y", "@davincibets/mcp-server@latest"],
      "env": {
        "DVB_API_KEY": "dvb_live_your_key_here"
      }
    }
  }
}

Cursor

Open Settings → MCP Servers → Add:

• Name: davinci-bets
• Command: npx
• Args: -y @davincibets/mcp-server@latest
• Env: DVB_API_KEY=dvb_live_your_key_here

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "davinci-bets": {
      "command": "npx",
      "args": ["-y", "@davincibets/mcp-server@latest"],
      "env": {
        "DVB_API_KEY": "dvb_live_your_key_here"
      }
    }
  }
}

3. Ask your AI

Once connected, you can ask naturally:

• "What are today's highest confidence NBA picks?"
• "Show me NFL spread predictions for this week"
• "Get the top 5 picks across all sports"
• "Generate a pick card image for the Lakers game"
• "What's the MLB schedule with predictions?"

Tools

get_predictions

Fetch AI predictions by sport, market, and confidence.

Parameter	Type	Default	Description
sport	NBA, NFL, NHL, MLB	all	Filter by sport
market	moneyline, spread, totals	moneyline	Betting market
sort	confidence, edge, game_time	confidence	Sort order
limit	1-50	25	Max results
min_confidence	0-100	60	Minimum confidence %

get_top_picks

Get the highest-conviction picks across all sports and markets.

Parameter	Type	Default	Description
count	1-20	10	Number of top picks
min_confidence	0-100	65	Minimum confidence %

get_schedule

Get today's game schedule with predictions for a sport.

Parameter	Type	Required	Description
sport	NBA, NFL, NHL, MLB	Yes	Which sport

get_pick_card

Render a prediction as a shareable 1080x1350 PNG image.

Parameter	Type	Required	Description
game_id	string	Yes	Game ID from predictions
sport	NBA, NFL, NHL, MLB	No	Sport hint

get_batch_cards

Render multiple pick cards at once (up to 10). Designed for marketing teams.

Parameter	Type	Required	Description
game_ids	string[]	Yes	Array of game IDs (max 10)
sport	NBA, NFL, NHL, MLB	No	Sport hint

get_performance

Get current prediction performance snapshot.

Parameter	Type	Default	Description
sport	NBA, NFL, NHL, MLB	all	Filter by sport
market	moneyline, spread, totals	all	Filter by market

Rate Limits

Tier	Per Hour	Per Day	Who
Personal	50	500	$8/mo subscribers
Partner	500	10,000	Marketing agencies (DVB-Social)
Internal	Unlimited	Unlimited	Da Vinci Bets systems

Rate limit info is included in prediction responses. When limits are hit, the server returns a clear error with retry timing.

For Marketing Teams (Partner Tier)

DVB-Social and marketing partners get elevated rate limits for batch content generation:

# Example workflow in Claude:
1. "Get today's NBA moneyline predictions"
2. "Generate pick cards for all games above 70% confidence"
3. "Also get the NHL schedule and render those cards too"

The get_batch_cards tool can render up to 10 cards per call — ideal for daily social media pipelines.

Contact [e-mail] for partner API key provisioning.

Environment Variables

Variable	Required	Description
DVB_API_KEY	Yes	Your API key (dvb_live_xxx)
DVB_API_URL	No	Override API base URL (default: https://www.davincibets.io)

Requirements

• Node.js 18+
• A Da Vinci Bets premium subscription ($8/mo)
• An API key from Settings → API tab

Development

# Clone and install
cd packages/mcp-server
npm install

# Run locally
DVB_API_KEY=dvb_live_xxx npm run dev

# Build
npm run build

License

MIT