willvelida/mcp-afl-server

This is a Model Context Protocol (MCP) server that provides AFL (Australian Football League) data from the Squiggle API. It allows you to retrieve information about past AFL games, current and past standings, team information, power rankings, tips, and projections.
✨ Features
This MCP Server offers comprehensive access to AFL data, providing tools for:
- 🏆 Retrieving current AFL standings
- 📊 Retrieving past AFL standings by round and year
- 🎯 Retrieving results from particular games or rounds
- 👥 Retrieving basic information about teams
- 📅 Retrieving lists of teams who played in particular seasons
- 🔮 Getting tips and predictions for games
- 📈 Accessing power rankings and projected ladders
- 🔍 Managing data sources and configurations
📋 Prerequisites
- .NET 9.0 or later
- A Model Context Protocol (MCP) compatible client (e.g., Claude for Desktop)
- Internet connection for accessing the Squiggle API
⚡ Quick Install
🎯 Claude Desktop Integration
1. Edit the Claude for Desktop config file:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
2. Add the server configuration:
🚀 What can you do with the AFL MCP Server?
Here are some example prompts you can try once connected:
🏆 Current Season Information
- "What are the current AFL standings?"
- "Show me the results from Round 10, 2024"
- "Get information about the Richmond Tigers"
- "List all teams that played in the 2024 season"
📊 Historical Data
- "What were the standings after Round 15 in 2023?"
- "Show me all results from Round 1, 2022"
- "Get the result of a specific game"
🔮 Tips & Predictions
- "What are the current tips for upcoming games?"
- "Show me tips for Round 5, 2024"
- "Get tips for a specific game"
📈 Advanced Analytics
- "Show me the power rankings for Round 20, 2023"
- "Get the projected ladder for Round 15, 2024"
- "List all available data sources"
📡 Squiggle API
This server uses the Squiggle API to retrieve AFL data. The API provides comprehensive methods to fetch:
- 🎯 Live scores and fixtures
- 📊 Historical match results
- 👥 Team information and statistics
- 🏆 Ladder positions and standings
- 🔮 Tips and predictions
- 📈 Power rankings and projections
Please use the API responsibly! All information about proper usage can be found at api.squiggle.com.au.
🛠️ MCP Tools
The server exposes the following tools through the Model Context Protocol:
🎯 Game Information
| **Tool** | **Description** |
|:--------:|:---------------:|
| GetGameResult | Gets result from a played game |
| GetRoundResultsByYear | Get the results from a round of a particular year |
🏆 Standings Information
| **Tool** | **Description** |
|:--------:|:---------------:|
| GetCurrentStandings | Gets the current standings of the AFL |
| GetStandingsByRoundAndYear | Get the standings for a particular round and year |
👥 Team Information
| **Tool** | **Description** |
|:--------:|:---------------:|
| GetTeamInfo | Gets information for an AFL team |