mcp-afl-server

🏈 AFL (Australian Football League) MCP 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

1. Add the server configuration:

{
    "mcpServers": {
        "mcp-afl-server": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "C:\\path\\to\\mcp-afl-server\\src",
                "--no-build"
            ]
        }
    }
}

🚀 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 | | GetTeamsBySeason | Gets a list of teams who played in a particular season |

🔮 Tips & Predictions

| Tool | Description | |:--------:|:---------------:| | GetFutureTips | Get the tips for current and future games | | GetTipsByGame | Get the tips of a particular game | | GetTipsByRoundAndYear | Get the tips for a particular round and year |

📈 Power Rankings & Projections

| Tool | Description | |:--------:|:---------------:| | GetPowerRankingByRoundAndYear | Get Power Ranking by Round and Year | | GetPowerRankingByRoundYearAndSource | Get Power Ranking by Round, Year, and Model Source | | GetTeamPowerRankingByRoundAndYear | Get Power Ranking for Team by Round, Year, and Model Source | | GetProjectedLadderByRoundAndYear | Get the projected ladder for a particular round and year | | GetProjectedLadderByRoundAndYearBySource | Get the projected ladder by source for a particular round and year |

🔍 Sources & Configuration

| Tool | Description | |:--------:|:---------------:| | GetSources | Gets a list of sources | | GetSourceById | Gets a source |

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Feedback

We're building this in the open and your feedback is much appreciated!

🐛 Report a bug or request a feature

Your input helps shape the future of the AFL MCP Server and makes it better for everyone in the AFL community.

🏈 About AFL

The 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.

---

Built with ❤️ for the AFL community