Lumify Sports Intelligence

ai.lumifyv1.0.1Updated Sep 29, 2026

Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.

VerifiedStreamable HTTPWeb executableAI & ML

Installation

In SourceWeft

Open Lumify Sports Intelligence in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sports-intelligence": {
      "type": "http",
      "url": "https://lumify.ai/mcp"
    }
  }
}

README

Lumify — Client SDKs & MCP

[smithery badge] [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.

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);

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

python

import osfrom 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"))

import osfrom 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

bash

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

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):

json

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

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

Local stdio (clients without remote MCP support):

json

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

{  "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

bash

cd examples/scoreboardnpm install && cp .env.example .env   # set LUMIFY_API_KEYnpm start                             # → http://localhost:3000

cd examples/scoreboardnpm install && cp .env.example .env   # set LUMIFY_API_KEYnpm start                             # → http://localhost:3000

Documentation

API reference: https://lumify.ai/docs/reference
OpenAPI: https://lumify.ai/docs/openapi (schema: /openapi.json · ReDoc · Swagger UI)
Guides (incl. MCP): https://lumify.ai/docs/guides
Quick start: docs/getting-started/quick-start.md
Agent cookbook: docs/agent-cookbook.md
Postman collection: docs/lumify.postman_collection.json

Support & contributing

Questions and bugs: open an issue
Contribution guidelines: CONTRIBUTING.md

License

Source: README.md at commit f43af0f

Tools

Tool metadata has not been indexed yet.

Version history

v1.0.1LatestSep 16, 2026