Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http lumify-sports-intelligence 'https://lumify.ai/mcp' --header 'Authorization: <Lumify API key as a Bearer token ('\''Bearer lmfy-...'\''). Get one free in seconds with no signup at https://lumify.ai/docs/ai, or create an account key at https://lumify.ai/api-keys. The server never stores your key.>'
{
"mcpServers": {
"lumify-sports-intelligence": {
"type": "http",
"url": "https://lumify.ai/mcp",
"headers": {
"Authorization": "<Lumify API key as a Bearer token ('Bearer lmfy-...'). Get one free in seconds with no signup at https://lumify.ai/docs/ai, or create an account key at https://lumify.ai/api-keys. The server never stores your key.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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 (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 |
| 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
- 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
MIT © 2026 Lumify AI
الأسئلة الشائعة
ما هو Lumify Sports Intelligence؟
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
كيف أثبّت Lumify Sports Intelligence؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http lumify-sports-intelligence 'https://lumify.ai/mcp' --header 'Authorization: <Lumify API key as a Bearer token ('\''Bearer lmfy-...'\''). Get one free in seconds with no signup at https://lumify.ai/docs/ai, or create an account key at https://lumify.ai/api-keys. The server never stores your key.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Lumify Sports Intelligence إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Lumify Sports Intelligence مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Lumify Sports Intelligence؟
ينشره lumifyai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.