# Lumify — how to use (mcp.ai)

Connect your Lumify account and use 10 tools for lifestyle and entertainment straight from your AI agent. Connect with your own API key. Lumify provides sports schedules, live scores, odds, statistics, and explainable betting intelligence through a credit-metered API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_lumify?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `lumify_get_credit_usage`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/lumify`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/lumify/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/lumify/get/credit/usage` — Get the Lumify account tier, usage, limits, trial state, and remaining credits. The response body is a pre-call snapshot and this request costs one credit. When Lumify returns X-Credits-Remaining, the
- `POST https://api.mcp.ai/api/lumify/get/event/analysis` — Fetch selected intelligence, odds, odds history, public splits, and/or deterministic stats for one event. Each selected section makes a separate request against Lumify's 20 requests-per-minute limit. 
  - body: { event_id: integer, sections: string[], bookmaker?: string, odds_history_limit?: integer }
- `POST https://api.mcp.ai/api/lumify/get/event/score` — Get a compact current score and status snapshot for one Lumify event. A successful available response normally costs 1 credit and consumes 1 of the connected key's 20 requests per minute.
  - body: { event_id: integer }
- `POST https://api.mcp.ai/api/lumify/get/events` — Fetch full details for 1-25 event IDs in one API request, optionally including odds or intelligence. Credits are charged per found event, duplicate IDs are billed once, and missing IDs are returned in
  - body: { bookmaker?: string, event_ids: integer[], include_odds?: boolean, include_intelligence?: boolean }
- `POST https://api.mcp.ai/api/lumify/list/events` — Find scheduled, live, or historical Lumify events with structured filters and one-page cursor pagination. A successful page normally costs one credit and uses one request from the connected key's rate
  - body: { date?: string, limit?: integer, sport?: string, league?: string, status?: string, team_id?: integer, to_date?: string, from_date?: string, season_id?: integer, next_cursor?: string, has_recommend?: boolean, include_scores?: boolean }
- `POST https://api.mcp.ai/api/lumify/list/player/events` — List one Lumify player's schedule and results with date and status filters, returning one cursor-controlled page. A successful page normally costs one credit and uses one request from the connected ke
  - body: { limit?: integer, status?: string, to_date?: string, from_date?: string, player_id: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/lumify/list/sports/or/seasons` — List Lumify sports and leagues or seasons. Use this reference lookup before filtering events by sport, league, or season identifier.
  - body: { sport?: string, resource: string, active_only?: boolean, current_only?: boolean }
- `POST https://api.mcp.ai/api/lumify/plan/credit/costs` — Discover Lumify estimator tool identifiers or estimate credit ranges for up to 50 planned calls without executing them. Both modes cost zero credits but consume one request from Lumify's rate limit. O
  - body: { calls?: object[] }
- `POST https://api.mcp.ai/api/lumify/search/players` — Search Lumify players by sport, partial name, country, activity, or tennis ranking and return one cursor-controlled page. A successful page normally costs one credit and uses one request from the conn
  - body: { limit?: integer, query?: string, sport?: string, active?: boolean, ranked?: boolean, country?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/lumify/search/teams` — Search teams by sport, league, conference, division, country, active status, or partial team name and return one cursor-controlled page. A successful page normally costs 1 credit and consumes 1 of 20 
  - body: { limit?: integer, query?: string, sport?: string, active?: boolean, league?: string, country?: string, division?: string, conference?: string, next_cursor?: string }

## Example prompts
- "What can I do in Lumify?"
- "Show me a summary of my Lumify account"

## More
- Page: https://mcp.ai/lumify
- Agent spec (llms.txt): https://mcp.ai/lumify/llms.txt
- Postman collection: https://mcp.ai/lumify/postman.json