Developer Documentation

Predictions API & MCP Server

Access AI-powered sports predictions programmatically. Feed picks into your own tools, spreadsheets, or AI workflows.

Quick Start
Quick StartREST APIMCP ServerResponseRate LimitsCardsFAQ

Quick Start

1

Get your API key

Go to Settings → API tab and click Generate Key. Requires a premium subscription ($8/mo). Your key starts with dvb_live_ — copy it immediately (shown once).

2

Make your first request

Send a GET request with your key as a Bearer token.

Terminalbash
curl -s https://www.davincibets.io/api/v1/predictions \
  -H "Authorization: Bearer dvb_live_your_key_here" \
  -G -d "sport=NBA" -d "market=moneyline" -d "team=Lakers" -d "limit=5" | jq .
3

Use predictions in your workflow

Feed predictions into spreadsheets, Discord bots, Notion dashboards, or your own AI analysis pipeline. Each prediction includes confidence scores, win probabilities, odds, and edge values.

REST API

GET/api/v1/predictions

Fetch AI predictions filtered by sport, market, and confidence threshold.

Authorization: Bearer dvb_live_your_key

Query Parameters

ParamDescription
sportNBA | NFL | NHL | MLB · Filter by sport
marketmoneyline | spread | totals · Betting market type
sortconfidence | edge | game_time · Sort order
limit1-50 · Max results per request
min_confidence0-100 · Minimum confidence %
teamstring · Filter by team name, abbreviation, or city (e.g., Lakers, NYY, Boston)

Base URL: https://www.davincibets.io — All requests require HTTPS.

MCP Server

The Model Context Protocol (MCP) server gives your AI assistant native access to predictions. Ask Claude, Cursor, or Windsurf naturally: "What are the top NBA picks today?"

Private ChatGPT Connector

For ChatGPT developer mode and remote MCP clients.

Remote MCPtext
Private MCP endpoint
https://www.davincibets.io/api/mcp

Health check
https://www.davincibets.io/api/mcp/health

Optional private auth
Authorization: Bearer YOUR_CHATGPT_MCP_SECRET

Server-side env
CHATGPT_DVB_API_KEY=dvb_live_your_key_here

Public-safe Connector

Schedules, scores, track record — no auth needed.

Public MCPtext
Public-safe MCP endpoint
https://www.davincibets.io/api/mcp/public

Health check
https://www.davincibets.io/api/mcp/public/health

Public-safe tools
- get_schedule
- get_live_scores
- get_track_record
- search_public_pages
- fetch_public_page
- get_responsible_play_info

Add to ~/.config/Claude/claude_desktop_config.json

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

Available Tools

get_predictions

Fetch predictions by sport, market, team, confidence.

get_game

Find a game by team name — intelligent fuzzy lookup.

get_top_picks

Highest-conviction picks across all sports.

lookup_teams

Search 124 teams by name, abbreviation, or city.

get_schedule

Today's game schedule with prediction summaries.

get_pick_card

Render a pick card by game ID or team name.

get_batch_cards

Render up to 10 pick cards at once.

get_performance

Active picks by sport, market, confidence.

get_track_record

Historical win rate, ROI, and streak data.

Response Format

Every prediction includes confidence scores, win probabilities, live odds, and edge values. Confidence is 0–100%, and edge is the gap between our model and implied market odds.

Example Responsejson
{
  "predictions": [
    {
      "game_id": "bdl_nba_12345678",
      "sport": "NBA",
      "market": "moneyline",
      "home_team": "Boston Celtics",
      "away_team": "Los Angeles Lakers",
      "commence_time": "2026-04-04T23:30:00Z",
      "predicted_winner": "Boston Celtics",
      "confidence": 72.5,
      "home_win_probability": 72.5,
      "away_win_probability": 27.5,
      "home_odds": -185,
      "away_odds": 155,
      "home_edge": 4.8,
      "away_edge": -4.8,
      "confidence_tier": "HIGH",
      "has_market_odds": true
    }
  ],
  "meta": {
    "total": 1,
    "sport": "NBA",
    "market": "moneyline",
    "sort": "confidence",
    "min_confidence": 60,
    "team_filter": "Lakers",
    "generated_at": "2026-04-04T18:00:00.000Z",
    "response_time_ms": 45
  },
  "rate_limit": {
    "remaining_hour": 47,
    "remaining_day": 495,
    "limit_hour": 50,
    "limit_day": 500
  }
}
confidence

Model confidence (0-100%)

home_edge

Edge over implied odds (%)

predicted_winner

Model's pick for this game

confidence_tier

HIGH, MEDIUM, or LOW

has_market_odds

Live odds availability

commence_time

Game start (UTC ISO 8601)

Market-Specific Fields

spread adds: predicted_pick, spread_line

totals adds: predicted_direction (OVER/UNDER), totals_line

Rate Limits

Tier/Hour/Day
Personal50500
Partner50010,000

Rate limits are enforced atomically in PostgreSQL. When limits are hit, you get a 429 with Retry-After and X-RateLimit-* headers.

Tip: get_top_picks fetches 3 markets in parallel, consuming 3 requests per call.

Pick Card Images

Render any prediction as a shareable 1080×1350 PNG — designed for social media.

Card Image APIbash
# Render a single pick card
curl -o card.png "https://www.davincibets.io/api/card-image/bdl_nba_12345678"

# List all available cards for today
curl "https://www.davincibets.io/api/card-image?sport=NBA&date=2026-04-04"

Card Image Endpoints

GET /api/card-image/{game_id} — PNG image. Public, no auth.

GET /api/card-image — JSON index of available cards.

Cards cached at CDN level (5 min browser, 1 hour edge). Game IDs come from the predictions API.

FAQ

Ready to integrate?

Generate your API key and start fetching predictions in under 2 minutes.

View Pricing