AFL (Australian Football League) MCP Server

1# 🏈 AFL (Australian Football League) MCP Server
2 
3This 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.
4 
5[![.NET](https://img.shields.io/badge/.NET-9.0-512BD4?style=flat-square&logo=dotnet&logoColor=white)](https://dotnet.microsoft.com/download/dotnet/9.0)
6[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
7[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg?style=flat-square)](https://modelcontextprotocol.io)
8 
9## ✨ Features
10 
11This MCP Server offers comprehensive access to AFL data, providing tools for:
12 
13- 🏆 Retrieving current AFL standings
14- 📊 Retrieving past AFL standings by round and year
15- 🎯 Retrieving results from particular games or rounds
16- 👥 Retrieving basic information about teams
17- 📅 Retrieving lists of teams who played in particular seasons
18- 🔮 Getting tips and predictions for games
19- 📈 Accessing power rankings and projected ladders
20- 🔍 Managing data sources and configurations
21 
22## 📋 Prerequisites
23 
24- [.NET 9.0](https://dotnet.microsoft.com/download/dotnet/9.0) or later
25- A Model Context Protocol (MCP) compatible client (e.g., Claude for Desktop)
26- Internet connection for accessing the Squiggle API
27 
28## ⚡ Quick Install
29 
30### 🎯 Claude Desktop Integration
31 
321. Edit the Claude for Desktop config file:
33   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
34   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
35 
362. Add the server configuration:
37 
38```json
39{
40    "mcpServers": {
41        "mcp-afl-server": {
42            "command": "dotnet",
43            "args": [
44                "run",
45                "--project",
46                "C:\\path\\to\\mcp-afl-server\\src",
47                "--no-build"
48            ]
49        }
50    }
51}
52```
53 
54## 🚀 What can you do with the AFL MCP Server?
55 
56Here are some example prompts you can try once connected:
57 
58### 🏆 Current Season Information
59 
60- "What are the current AFL standings?"
61- "Show me the results from Round 10, 2024"
62- "Get information about the Richmond Tigers"
63- "List all teams that played in the 2024 season"
64 
65### 📊 Historical Data
66 
67- "What were the standings after Round 15 in 2023?"
68- "Show me all results from Round 1, 2022"
69- "Get the result of a specific game"
70 
71### 🔮 Tips & Predictions
72 
73- "What are the current tips for upcoming games?"
74- "Show me tips for Round 5, 2024"
75- "Get tips for a specific game"
76 
77### 📈 Advanced Analytics
78 
79- "Show me the power rankings for Round 20, 2023"
80- "Get the projected ladder for Round 15, 2024"
81- "List all available data sources"
82 
83## 📡 Squiggle API
84 
85This server uses the Squiggle API to retrieve AFL data. The API provides comprehensive methods to fetch:
86 
87- 🎯 Live scores and fixtures
88- 📊 Historical match results
89- 👥 Team information and statistics
90- 🏆 Ladder positions and standings
91- 🔮 Tips and predictions
92- 📈 Power rankings and projections
93 
94Please use the API responsibly! All information about proper usage can be found at [api.squiggle.com.au](api.squiggle.com.au).
95 
96## 🛠️ MCP Tools
97 
98The server exposes the following tools through the Model Context Protocol:
99 
100### 🎯 Game Information
101 
102| **Tool** | **Description** |
103|:--------:|:---------------:|
104| `GetGameResult` | Gets result from a played game |
105| `GetRoundResultsByYear` | Get the results from a round of a particular year |
106 
107### 🏆 Standings Information
108 
109| **Tool** | **Description** |
110|:--------:|:---------------:|
111| `GetCurrentStandings` | Gets the current standings of the AFL |
112| `GetStandingsByRoundAndYear` | Get the standings for a particular round and year |
113 
114### 👥 Team Information
115 
116| **Tool** | **Description** |
117|:--------:|:---------------:|
118| `GetTeamInfo` | Gets information for an AFL team |
119| `GetTeamsBySeason` | Gets a list of teams who played in a particular season |
120 
121### 🔮 Tips & Predictions
122 
123| **Tool** | **Description** |
124|:--------:|:---------------:|
125| `GetFutureTips` | Get the tips for current and future games |
126| `GetTipsByGame` | Get the tips of a particular game |
127| `GetTipsByRoundAndYear` | Get the tips for a particular round and year |
128 
129### 📈 Power Rankings & Projections
130 
131| **Tool** | **Description** |
132|:--------:|:---------------:|
133| `GetPowerRankingByRoundAndYear` | Get Power Ranking by Round and Year |
134| `GetPowerRankingByRoundYearAndSource` | Get Power Ranking by Round, Year, and Model Source |
135| `GetTeamPowerRankingByRoundAndYear` | Get Power Ranking for Team by Round, Year, and Model Source |
136| `GetProjectedLadderByRoundAndYear` | Get the projected ladder for a particular round and year |
137| `GetProjectedLadderByRoundAndYearBySource` | Get the projected ladder by source for a particular round and year |
138 
139### 🔍 Sources & Configuration
140 
141| **Tool** | **Description** |
142|:--------:|:---------------:|
143| `GetSources` | Gets a list of sources |
144| `GetSourceById` | Gets a source |
145 
146## 📜 License
147 
148This project is licensed under the [MIT License](LICENSE) - see the LICENSE file for details.
149 
150## 💬 Feedback
151 
152We're building this in the open and your feedback is much appreciated! 
153 
154🐛 [Report a bug or request a feature](https://github.com/willvelida/mcp-afl-server/issues/new)
155 
156Your input helps shape the future of the AFL MCP Server and makes it better for everyone in the AFL community.
157 
158## 🏈 About AFL
159 
160The Australian Football League (AFL) is the premier professional Australian rules football competition in Australia. This server provides programmatic access to comprehensive AFL data to enhance your analysis, applications, and understanding of the game.
161 
162---
163 
164**Built with ❤️ for the AFL community**