Lumify Sports Intelligence

Lumify — クライアント SDK と MCP

Lumify の公式クライアントライブラリとモデルコンテキストプロトコル （MCP）連携です。Lumify は、エージェントに対応したスポーツインテリジェンス API です。MLB、NFL、 NCAAF、NCAAB、NBA、NHL、テニス、サッカー（MLS、EPL、La Liga、 Serie A、Bundesliga、Ligue 1、UEFA Champions League）を対象に、リアルタイムの試合日程、ライブスコア、オッズ、ラインの変動、 ベッティングの一般投票割合、説明可能な AI ベット信頼度を提供します。

このリポジトリは、クライアント SDK、MCP stdio ブリッジ、開発者向けドキュメント／サンプルの公開リポジトリです。Lumify 自体はホスト型 API として https://lumify.ai で提供されており、サーバーを自分で実行する必要はありません。

API キーを取得する

ここにあるすべての機能で、Lumify API キー（lmfy-...）を使って認証します。

• 最速 — 登録不要： https://lumify.ai/docs/ai から無料の即時トライアルキーを取得します（「Get instant trial key」をクリック）。アカウント、 メールアドレス、クレジットカードは不要です。100 クレジット、有効期限は 14 日間です。キーを貼り付けて、すぐに API を呼び出せます。
• 継続利用するアカウント： https://lumify.ai/api-keys でキーを作成します。 クレジットカード不要の無料トライアルで、1,000 クレジットを利用できます。

export LUMIFY_API_KEY="lmfy-xxxxxx.yyyyyyyy"

パッケージ

ランタイム	パッケージ	インストール	ドキュメント
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 ブリッジ	@lumifyai/mcp	npx -y @lumifyai/mcp	README

クイックスタート

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"

AI エージェントから使用する（MCP）

Lumify は https://lumify.ai/mcp でホスト型 MCP サーバーを実行しています（Streamable HTTP、 JSON モード、ステートレス）。MCP 対応クライアントから接続できます。

リモート（Cursor、VS Code、リモート対応の Claude Desktop）：

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

ローカル stdio（リモート MCP に対応していないクライアント）：

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

ツールの全カタログについては、MCP ブリッジの README と MCP ガイドをご覧ください。

サンプル

デモ	パス	チュートリアル
ライブスポーツスコアボード	examples/scoreboard	ライブスポーツスコアボードを構築する

cd examples/scoreboard
npm install && cp .env.example .env   # set LUMIFY_API_KEY
npm start                             # → http://localhost:3000

ドキュメント

• API リファレンス： https://lumify.ai/docs/reference
• OpenAPI： https://lumify.ai/docs/openapi（スキーマ：/openapi.json · ReDoc · Swagger UI）
• ガイド（MCP を含む）： https://lumify.ai/docs/guides
• クイックスタート： docs/getting-started/quick-start.md
• エージェント向けクックブック： docs/agent-cookbook.md
• Postman コレクション： docs/lumify.postman_collection.json

サポートと貢献

• 質問やバグ： issue を作成
• 貢献ガイドライン：CONTRIBUTING.md

ライセンス

MIT © 2026 Lumify AI