Skip to main content
Glama
Lumify Sports Intelligence

Lumify Sports Intelligence

Lumify — Client SDKs & MCP

lumify MCP server

Official client libraries and Model Context Protocol (MCP) integration for Lumify, the agent-ready sports-intelligence API: real-time schedules, live scores, odds, line movement, public betting splits, and explainable AI bet confidence across MLB, NFL, NCAAF, NCAAB, NBA, NHL, tennis, and soccer (MLS, EPL, La Liga, Serie A, Bundesliga, Ligue 1, and UEFA Champions League).

This repository is the public home for the client SDKs, the MCP stdio bridge, and developer docs/examples. Lumify itself is a hosted API at https://lumify.ai — you don't run a server yourself.

Get an API key

Everything here authenticates with a Lumify API key (lmfy-...).

  • Fastest — no signup: grab a free instant trial key at https://lumify.ai/docs/ai (click "Get instant trial key"). No account, email, or credit card — 100 credits, 14-day expiry. Paste it and start calling.

  • Persistent account: create a key at https://lumify.ai/api-keys — free trial with 1,000 credits, no credit card required.

export LUMIFY_API_KEY="lmfy-xxxxxx.yyyyyyyy"

Related MCP server: PropLine

Packages

Runtime

Package

Install

Docs

TypeScript / JavaScript

@lumifyai/sdk

npm install @lumifyai/sdk

README

Python

lumify-sdk

pip install lumify-sdk

README

LangChain

langchain-lumify

pip install langchain-lumify

README

LlamaIndex

llamaindex-lumify

pip install llamaindex-lumify

README

CrewAI

crewai-lumify

pip install crewai-lumify

README

MCP stdio bridge

@lumifyai/mcp

npx -y @lumifyai/mcp

README

Quick start

TypeScript

import { Lumify } from "@lumifyai/sdk";

const client = new Lumify({ apiKey: process.env.LUMIFY_API_KEY! });

const { sports } = await client.sports.list();
const event = await client.events.get(12345, { includeOdds: true, includeIntelligence: true });
console.log(event.status, event.intelligence?.bets);

Python

import os
from lumify import Lumify

client = Lumify(api_key=os.environ["LUMIFY_API_KEY"])

sports = client.sports.list()
event = client.events.get(12345, include_odds=True, include_intelligence=True)
print(event["status"], event.get("intelligence"))

curl

curl https://lumify.ai/v1/events?sport=nfl&status=inprogress \
  -H "Authorization: Bearer $LUMIFY_API_KEY"

Use it from an AI agent (MCP)

Lumify runs a hosted MCP server at https://lumify.ai/mcp (Streamable HTTP, JSON mode, stateless). Point any MCP-compatible client at it.

Remote (Cursor, VS Code, Claude Desktop with remote support):

{
  "mcpServers": {
    "lumify": {
      "url": "https://lumify.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Local stdio (clients without remote MCP support):

{
  "mcpServers": {
    "lumify": {
      "command": "npx",
      "args": ["-y", "@lumifyai/mcp"],
      "env": { "LUMIFY_API_KEY": "YOUR_API_KEY" }
    }
  }
}

See the MCP bridge README and the MCP guide for the full tool catalog.

Examples

Demo

Path

Tutorial

Live sports scoreboard

examples/scoreboard

Build a live sports scoreboard

cd examples/scoreboard
npm install && cp .env.example .env   # set LUMIFY_API_KEY
npm start                             # → http://localhost:3000

Documentation

Support & contributing

License

MIT © 2026 Lumify AI

Available Tools

10 tools
batch_get_eventsA
Read-onlyIdempotent
Inspect

Get multiple events by id in one call — for agents that already have a list of ids and want full detail for each without one call per event. Max 25 ids. Returns full detail for every id that exists plus a not_found list for any that don't (never billed). Use get_event for a single id, or list_events / query_events to discover ids first.

Inputs: event_ids (required), bookmaker, include_odds, include_intelligence. Returns: total, events, not_found

get_eventA
Read-onlyIdempotent
Inspect

Get a single event with participants and venue. Optionally inline current odds and/or bet intelligence (+1 credit each, only charged when that data is actually available). Raises a not-found error if event_id doesn't exist. Use list_events / query_events to discover ids first, or batch_get_events to fetch several ids in one call.

Inputs: event_id (required), bookmaker, include_odds, include_intelligence. Returns: id, name, sport, venue, +5 more

get_oddsA
Read-onlyIdempotent
Inspect

Get current betting odds for an event: per-bookmaker lines and last-updated time. bookmaker defaults to pinnacle; use 'all' for every book (costs 1 credit per book returned). Returns available:false with no charge if odds aren't posted for this event yet. Use get_odds_history for line movement over time instead of the current line.

Inputs: event_id (required), bookmaker. Returns: event_id, available, bookmakers, last_updated

get_odds_historyA
Read-onlyIdempotent
Inspect

Get line-movement history for an event: a list of past odds snapshots (movements), each with its own timestamp, up to limit entries. bookmaker defaults to pinnacle. Use get_odds instead if you only need the current line.

Inputs: event_id (required), limit, bookmaker. Returns: total, event_id, movements

get_playerA
Read-onlyIdempotent
Inspect

Get a single player profile: name, sport, country, position/handedness, physical stats, current team, and tennis ranking if applicable. Raises a not-found error if player_id doesn't exist. Resolve ids via search_players.

Inputs: player_id (required). Returns: id, slug, sport, position, +10 more

get_player_eventsA
Read-onlyIdempotent
Inspect

List a player's events (schedule/results), paginated by id (after_id). Defaults to ±30 days around today when no date filter is given. Resolve player_id via search_players first.

Inputs: player_id (required), to, from, limit, +2 more. Returns: data, has_more, player_id, next_after_id

get_splitsA
Read-onlyIdempotent
Inspect

Get public betting splits (bets% and handle%) for an event: a consensus split plus a per-book breakdown, with a captured_at timestamp. Returns available:false with no charge if splits haven't been captured for this event yet.

Inputs: event_id (required). Returns: books, event_id, available, consensus, +1 more

list_seasonsA
Read-onlyIdempotent
Inspect

List seasons per sport/league, optionally filtered by sport or to the current season only. Returns each season's id, year, phase, start/end dates, and whether it is_current. Use list_sports for just each sport's current season.

Inputs: sport, current_only. Returns: total, seasons

list_teamsA
Read-onlyIdempotent
Inspect

List teams, paginated by id (after_id). Filter by sport, league, conference, division, country, active status, or name (q, partial match). Returns each team's id, slug, name, city, conference/division, and venue. Use get_team for full detail on one id once resolved here.

Inputs: q, limit, sport, active, +5 more. Returns: data, has_more, next_after_id

query_eventsA
Read-onlyIdempotent
Inspect

Search events with a natural-language query instead of structured filters — e.g. 'live nfl games today' or 'college basketball this week'. Rule-based (not an LLM): recognizes sport (nfl/nba/mlb/nhl/tennis/soccer/ncaaf/ncaab + aliases like hockey, american football, college basketball), status (live/final/upcoming/…), dates (today/tomorrow, this week, next N days, YYYY-MM-DD ranges). Bare 'football' is ambiguous and left unrecognized. Response includes interpreted filters, equivalent REST call, and unrecognized_terms. Prefer list_events when you already know the structured filters you want.

Inputs: query (required), limit. Returns: query, total, events, interpreted, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 10 tools

    Disambiguation4/5

    The tools split cleanly across events, odds, teams, players, and seasons, and there are explicit cross-references (e.g., get_event vs batch_get_events vs list_events/query_events). The only mild overlap is that get_odds, get_odds_history, and get_splits all relate to betting data, but each targets a distinct data type: current lines, line movement, and splits.

    Naming Consistency4/5

    Use of get_/list_/batch_/query_ conventions is mostly consistent: get_event, get_odds, get_player; list_teams, list_seasons; batch_get_events, query_events. One slight inconsistency is get_player_events (verb_noun_verb rather than get/get/list pattern) and list_teams/list_seasons vs batch_get_events, but overall naming is predictable.

    Tool Count5/5

    10 tools is well-scoped for a sports intelligence API covering events, odds, teams, players, and seasons. Each tool maps to a distinct resource or data type, with no obvious bloat or redundancy.

    Completeness4/5

    The surface covers event retrieval (single, batch, query), odds, splits, teams, players, player events, and seasons. Notable gaps: there is no tool for listing or searching sports/leagues directly (list_sports is referenced but not present), and no get_team tool even though list_teams says to use get_team for full detail. Also search_players is referenced but not present. These are minor omissions since the described tools still cover core read-only workflows, but the cross-references reveal missing dependencies.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      C
      maintenance
      Enables comprehensive Sleeper Fantasy Football integration with Claude, providing real-time player projections, historical performance analytics, league management, and waiver wire analysis. Supports advanced NFL metrics, lineup optimization, and matchup analysis for fantasy football decision-making.
      12
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      Live sports betting odds, cross-book +EV, and graded player-prop resolution across 13 books.
      11
      648 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive sports intelligence including live scores, standings, schedules, betting odds, news, highlights, and more via SSE transport.
      -