mcp-afl-server is a Model Context Protocol (MCP) server that provides Australian Football League (AFL) data through the Squiggle API. It is intended for users who need programmatic access to AFL matches, standings, teams, and prediction data, and can be used with MCP-compatible clients.
Purpose The server is used to retrieve AFL-related data, covering match results, standings, team information, power rankings, tips and predictions, and projected ladders. It allows users to retrieve and present this information from the Squiggle API through natural language prompts or tool calls.
Main capabilities The tools provided by the server cover the following data categories:
- Match information: retrieve the results of a specific match or round.
- Standings information: retrieve the current AFL standings, as well as historical standings by round and year.
- Team information: retrieve basic team information, as well as query the list of teams that played in a specific season.
- Power rankings and predictions: access power rankings and the projected ladder, as well as tips and predictions.
- Data sources and configuration: list and manage available data sources and configuration.
Usage Running the server requires the following prerequisites:
- .NET 9.0 or later.
- A Model Context Protocol (MCP)-compatible client (for example, Claude for Desktop).
- A network connection with access to the Squiggle API.
When integrating with Claude Desktop, edit the Claude for Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the server configuration to the configuration file. After connecting, you can try the following example prompts:
- 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 and predictions: "What are the current tips for upcoming games?", "Show me tips for Round 5, 2024", "Get tips for a specific game"
- Advanced analysis: "Show me the power rankings for Round 20, 2023", "Get the projected ladder for Round 15, 2024", "List all available data sources"
Use cases Suitable for scenarios that require retrieving and analyzing AFL data, such as querying standings and match results, learning team information, and retrieving match predictions and power rankings. It can be combined with MCP-compatible clients to complete data retrieval through natural language interaction.
Limitations When using the Squiggle API, use it responsibly. All information about proper use can be found at api.squiggle.com.au. The project uses the MIT license. Other information such as fees, pricing, and the specific scope of platform support is not provided in the materials.
