# Lumify — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/lumify

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_lumify?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/lumify/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/lumify/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/lumify/skill.md
Postman collection (v2.1): https://mcp.ai/lumify/postman.json

## Tools
- 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
- lumify_get_event_analysis(event_id: integer, sections: string[], bookmaker?: string, odds_history_limit?: integer) — 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. 
- lumify_get_event_score(event_id: integer) — 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.
- lumify_get_events(bookmaker?: string, event_ids: integer[], include_odds?: boolean, include_intelligence?: boolean) — 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
- lumify_list_events(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) — 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
- lumify_list_player_events(limit?: integer, status?: string, to_date?: string, from_date?: string, player_id: integer, next_cursor?: string) — 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
- lumify_list_sports_or_seasons(sport?: string, resource: string, active_only?: boolean, current_only?: boolean) — List Lumify sports and leagues or seasons. Use this reference lookup before filtering events by sport, league, or season identifier.
- lumify_plan_credit_costs(calls?: object[]) — 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
- lumify_search_players(limit?: integer, query?: string, sport?: string, active?: boolean, ranked?: boolean, country?: string, next_cursor?: string) — 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
- lumify_search_teams(limit?: integer, query?: string, sport?: string, active?: boolean, league?: string, country?: string, division?: string, conference?: string, next_cursor?: string) — 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 

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

## Links
Docs: https://mcp.ai/docs/mcps/lumify
Website: https://mcp.ai/mcps/lumify