Lumify — Client SDKs & MCP

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 (FIFA World Cup + 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"

Packages

Runtime	Package	Install	Docs
TypeScript / JavaScript	@lumifyai/sdk	npm install @lumifyai/sdk	README
Python	lumify-sdk	pip install lumify-sdk	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.

Documentation

• API reference: https://lumify.ai/docs/reference
• 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

MIT © 2026 Lumify AI