{
  "markdown": "# Lumify — Client SDKs & MCP\n\n[![smithery badge](https://smithery.ai/badge/lumify/sports-intelligence)](https://smithery.ai/servers/lumify/sports-intelligence)\n[![lumify MCP server](https://glama.ai/mcp/servers/lumifyai/lumify/badges/score.svg)](https://glama.ai/mcp/servers/lumifyai/lumify)\n\nOfficial client libraries and [Model Context Protocol](https://modelcontextprotocol.io)\n(MCP) integration for [**Lumify**](https://lumify.ai), the agent-ready\nsports-intelligence API: real-time schedules, live scores, odds, line movement,\npublic betting splits, and explainable AI bet confidence across MLB, NFL,\nNCAAF, NCAAB, NBA, NHL, tennis, and soccer (FIFA World Cup + MLS, EPL, La Liga,\nSerie A, Bundesliga, Ligue 1, and UEFA Champions League).\n\n> This repository is the public home for the **client SDKs, the MCP stdio\n> bridge, and developer docs/examples**. Lumify itself is a hosted API at\n> `https://lumify.ai` — you don't run a server yourself.\n\n## Get an API key\n\nEverything here authenticates with a Lumify API key (`lmfy-...`).\n\n- **Fastest — no signup:** grab a free **instant trial key** at\n  **<https://lumify.ai/docs/ai>** (click \"Get instant trial key\"). No account,\n  email, or credit card — 100 credits, 14-day expiry. Paste it and start calling.\n- **Persistent account:** create a key at **<https://lumify.ai/register>** —\n  free trial with 1,000 credits, no credit card required.\n\n```bash\nexport LUMIFY_API_KEY=\"lmfy-xxxxxx.yyyyyyyy\"\n```\n\n## Packages\n\n| Runtime | Package | Install | Docs |\n|---|---|---|---|\n| TypeScript / JavaScript | [`@lumifyai/sdk`](https://www.npmjs.com/package/@lumifyai/sdk) | `npm install @lumifyai/sdk` | [README](./clients/lumify-sdk/README.md) |\n| Python | [`lumify-sdk`](https://pypi.org/project/lumify-sdk/) | `pip install lumify-sdk` | [README](./clients/lumify-sdk-python/README.md) |\n| LangChain | [`langchain-lumify`](https://pypi.org/project/langchain-lumify/) | `pip install langchain-lumify` | [README](./clients/langchain-lumify/README.md) |\n| LlamaIndex | [`llamaindex-lumify`](https://pypi.org/project/llamaindex-lumify/) | `pip install llamaindex-lumify` | [README](./clients/llamaindex-lumify/README.md) |\n| CrewAI | [`crewai-lumify`](https://pypi.org/project/crewai-lumify/) | `pip install crewai-lumify` | [README](./clients/crewai-lumify/README.md) |\n| MCP stdio bridge | [`@lumifyai/mcp`](https://www.npmjs.com/package/@lumifyai/mcp) | `npx -y @lumifyai/mcp` | [README](./clients/lumify-mcp/README.md) |\n\n## Quick start\n\n### TypeScript\n\n```ts\nimport { Lumify } from \"@lumifyai/sdk\";\n\nconst client = new Lumify({ apiKey: process.env.LUMIFY_API_KEY! });\n\nconst { sports } = await client.sports.list();\nconst event = await client.events.get(12345, { includeOdds: true, includeIntelligence: true });\nconsole.log(event.status, event.intelligence?.bets);\n```\n\n### Python\n\n```python\nimport os\nfrom lumify import Lumify\n\nclient = Lumify(api_key=os.environ[\"LUMIFY_API_KEY\"])\n\nsports = client.sports.list()\nevent = client.events.get(12345, include_odds=True, include_intelligence=True)\nprint(event[\"status\"], event.get(\"intelligence\"))\n```\n\n### curl\n\n```bash\ncurl https://lumify.ai/v1/events?sport=nfl&status=inprogress \\\n  -H \"Authorization: Bearer $LUMIFY_API_KEY\"\n```\n\n## Use it from an AI agent (MCP)\n\nLumify runs a hosted MCP server at `https://lumify.ai/mcp` (Streamable HTTP,\nJSON mode, stateless). Point any MCP-compatible client at it.\n\n**Remote (Cursor, VS Code, Claude Desktop with remote support):**\n\n```json\n{\n  \"mcpServers\": {\n    \"lumify\": {\n      \"url\": \"https://lumify.ai/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n**Local stdio (clients without remote MCP support):**\n\n```json\n{\n  \"mcpServers\": {\n    \"lumify\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@lumifyai/mcp\"],\n      \"env\": { \"LUMIFY_API_KEY\": \"YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\nSee the [MCP bridge README](./clients/lumify-mcp/README.md) and the\n[MCP guide](https://lumify.ai/docs/guides#mcp) for the full tool catalog.\n\n## Examples\n\n| Demo | Path | Tutorial |\n|---|---|---|\n| Live sports scoreboard | [`examples/scoreboard`](./examples/scoreboard) | [Build a live sports scoreboard](https://lumify.ai/use-cases/live-scoreboard) |\n\n```bash\ncd examples/scoreboard\nnpm install && cp .env.example .env   # set LUMIFY_API_KEY\nnpm start                             # → http://localhost:3000\n```\n\n## Documentation\n\n- **API reference:** <https://lumify.ai/docs>\n- **Guides (incl. MCP):** <https://lumify.ai/docs/guides#mcp>\n- **Quick start:** [`docs/getting-started/quick-start.md`](./docs/getting-started/quick-start.md)\n- **Agent cookbook:** [`docs/agent-cookbook.md`](./docs/agent-cookbook.md)\n- **Postman collection:** [`docs/lumify.postman_collection.json`](./docs/lumify.postman_collection.json)\n\n## Support & contributing\n\n- Questions and bugs: [open an issue](https://github.com/lumifyai/lumify/issues)\n- Contribution guidelines: [`CONTRIBUTING.md`](./CONTRIBUTING.md)\n\n## License\n\n[MIT](./LICENSE) © 2026 Lumify AI\n",
  "bytes": 4995,
  "sha": "f2dab07cb21081122e03eb837d5ee28e2a7d25f644261b940bd927a08cc9f2e9",
  "repo_slug": "lumifyai/lumify",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_lumify_sports_intelligence_2eb7bf4f/readme"
}