Get Live Event
getLiveEventFetch live gameweek statistics for Fantasy Premier League matches. Filter results to specific players by providing element IDs for targeted performance data.
Instructions
Fetch focused live stats for a gameweek. Optionally filter to specific players by providing elementIds array.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gw | Yes | ||
| elementIds | No |
Implementation Reference
- src/fpl.ts:11-53 (handler)Core handler function that fetches live gameweek data, optionally filters by player element IDs, extracts essential stats, and returns structured player data.
export async function getLiveEvent(gw: number, elementIds?: number[]): Promise<any> { const data = await fetchLiveEventRaw(gw); // Filter elements if specific IDs requested let elements = data.elements || []; if (elementIds && elementIds.length > 0) { elements = elements.filter((element: any) => elementIds.includes(element.id)); } // Return only essential stats for each player const focusedElements = elements.map((element: any) => ({ id: element.id, stats: { minutes: element.stats.minutes, goals_scored: element.stats.goals_scored, assists: element.stats.assists, clean_sheets: element.stats.clean_sheets, goals_conceded: element.stats.goals_conceded, own_goals: element.stats.own_goals, penalties_saved: element.stats.penalties_saved, penalties_missed: element.stats.penalties_missed, yellow_cards: element.stats.yellow_cards, red_cards: element.stats.red_cards, saves: element.stats.saves, bonus: element.stats.bonus, bps: element.stats.bps, influence: element.stats.influence, creativity: element.stats.creativity, threat: element.stats.threat, ict_index: element.stats.ict_index, starts: element.stats.starts, expected_goals: element.stats.expected_goals, expected_assists: element.stats.expected_assists, expected_goal_involvements: element.stats.expected_goal_involvements, expected_goals_conceded: element.stats.expected_goals_conceded, total_points: element.stats.total_points, } })); return { elements: focusedElements }; } - src/server.ts:53-53 (schema)Zod input schema defining parameters: required gameweek (gw) as number, optional elementIds as array of numbers.
inputSchema: { gw: z.number(), elementIds: z.array(z.number()).optional() } - src/server.ts:50-64 (registration)Registers the 'getLiveEvent' tool with the MCP server, providing title, description, schema, and a wrapper that calls the core handler and formats the response.
server.registerTool("getLiveEvent", { title: "Get Live Event", description: "Fetch focused live stats for a gameweek. Optionally filter to specific players by providing elementIds array.", inputSchema: { gw: z.number(), elementIds: z.array(z.number()).optional() } }, async ({ gw, elementIds }) => { const data = await getLiveEvent(gw, elementIds); return { content: [ { type: "text", text: JSON.stringify(data) } ] }; }); - src/fpl.ts:6-9 (helper)Internal helper function to fetch raw live event data from the Fantasy Premier League API.
async function fetchLiveEventRaw(gw: number): Promise<any> { const res = await fetch(`https://fantasy.premierleague.com/api/event/${gw}/live/`); return res.json(); }