Description

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

(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 —

free trial with 1,000 credits, no credit card required.

export LUMIFYAPIKEY="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.LUMIFYAPIKEY! });
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(apikey=os.environ["LUMIFYAPI_KEY"])
sports = client.sports.list()
event = client.events.get(12345, includeodds=True, includeintelligence=True)
print(event["status"], event.get("intelligence"))

curl

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

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 YOURAPIKEY" }
    }
  }
}

Local stdio (clients without remote MCP support):

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

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

Documentation

• API reference:
• Guides (incl. MCP):
• Quick start: docs/getting-started/quick-start.md
• Agent cookbook: docs/agent-cookbook.md
• Postman collection: open an issue
• Contribution guidelines: CONTRIBUTING.md

License

MIT © 2026 Lumify AI