AFL MCP Server

AFL MCP Server

MCP-compatible server for comprehensive AFL data and analytics

View on GitHub
14
Stars
3
Forks
14
Watchers
4
Issues
AFL MCP Server is a Model Context Protocol-compatible backend that serves detailed Australian Football League data via the Squiggle API. It offers standardized access to live scores, historical match results, team information, rankings, tips, projections, and advanced analytics. Designed for integration with MCP clients such as Claude for Desktop, it exposes a suite of tools for retrieving game, standings, and team data. The server streamlines AFL data retrieval through automated protocols, facilitating robust AI-powered workflows.

Key Features

Retrieval of current AFL standings
Historical results by round and year
Comprehensive team information
Lists of teams by season
Game predictions and tips
Power rankings and projected ladders
Integration with MCP clients
Support for live scores
Management of data sources and configurations
Automated tooling for context-aware workflows

Use Cases

Displaying real-time AFL standings and results in user interfaces
Obtaining historical AFL match data for analytics or reporting
Fetching team details and seasonal participation information
Generating power rankings and projecting future leagues
Providing game tips and predictions to end-users
Integrating sports data into AI-powered summary or reasoning agents
Building statistical dashboards for AFL insights
Creating content or news based on current season outcomes
Supporting betting or fantasy sports platforms with up-to-date data
Facilitating academic research or visualization projects centered on AFL

README

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

.NET License MCP

✨ 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:

json
{
    "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

Star History

Star History Chart

Repository Owner

willvelida
willvelida

User

Repository Details

Language C#
Default Branch main
Size 149 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

C
86.65%
Bicep
11.83%
Powershell
1%
Dockerfile
0.51%

Tags

sports data

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Lara Translate MCP Server

    Lara Translate MCP Server

    Context-aware translation server implementing the Model Context Protocol.

    Lara Translate MCP Server enables AI applications to seamlessly access professional translation services via the standardized Model Context Protocol. It supports features such as language detection, context-aware translations, and translation memory integration. The server acts as a secure bridge between AI models and Lara Translate, managing credentials and facilitating structured translation requests and responses.

    • ⭐ 76
    • MCP
    • translated/lara-mcp
  • TeslaMate MCP Server

    TeslaMate MCP Server

    Query your TeslaMate data using the Model Context Protocol

    TeslaMate MCP Server implements the Model Context Protocol to enable AI assistants and clients to securely access and query Tesla vehicle data, statistics, and analytics from a TeslaMate PostgreSQL database. The server exposes a suite of tools for retrieving vehicle status, driving history, charging sessions, battery health, and more using standardized MCP endpoints. It supports local and Docker deployments, includes bearer token authentication, and is intended for integration with MCP-compatible AI systems like Claude Desktop.

    • ⭐ 106
    • MCP
    • cobanov/teslamate-mcp
  • Aviationstack MCP Server

    Aviationstack MCP Server

    MCP server offering comprehensive endpoints for aviation and flight data.

    Aviationstack MCP Server provides an MCP-compliant API that exposes tools to access real-time and scheduled flight data, aircraft details, random aircraft types, countries, and city information from the AviationStack API. It offers ready-to-use endpoints for airline-specific flight queries, airport schedules, and in-depth vehicle, country, and city data. The solution applies the Model Context Protocol by defining MCP tools as Python functions with standardized interfaces, designed for seamless integration into MCP-compatible environments. The server is built using Python, incorporates the FastMCP library, and is intended for easy deployment and use in application development.

    • ⭐ 11
    • MCP
    • Pradumnasaraf/aviationstack-mcp
  • Campertunity MCP Server

    Campertunity MCP Server

    Model Context Protocol server for AI-driven camping and outdoor recreation data

    Implements the Model Context Protocol (MCP) to provide AI models with structured access to camping and outdoor recreation data. Offers tools for searching, filtering, and booking campgrounds and sites based on a wide range of criteria. Enhances data accuracy with AI and aggregates information from multiple sources, enabling dynamic, real-time queries and bookings. Ideal for integrating intelligent camping experiences into AI-driven applications.

    • ⭐ 11
    • MCP
    • campertunity/mcp-server
  • AllTrails MCP Server

    AllTrails MCP Server

    MCP server for seamless AllTrails data access and integration

    AllTrails MCP Server provides Model Context Protocol (MCP) compliant access to AllTrails hiking trail data, enabling AI tools to search for trails and retrieve detailed trail information. It supports searching by national park and fetching comprehensive details such as difficulty, length, elevation, ratings, and route types. The server communicates via standard input/output and is designed for easy integration with MCP-compatible clients like Claude Desktop. Installation is flexible, supporting both virtual environments and system Python setups.

    • ⭐ 6
    • MCP
    • srinath1510/alltrails-mcp-server
  • mcp-national-rail

    mcp-national-rail

    Access live National Rail train data via MCP for AI agents.

    mcp-national-rail is a Model Context Protocol (MCP) server designed to enable AI agents to retrieve real-time and scheduled train information from National Rail using the Realtime Trains API. It facilitates live and historical lookups of departures and arrivals by exposing a set of tools through a standardized MCP interface. The server can be installed via Smithery or manually and configured for use with AI clients like Claude Desktop. Secure authentication with the Realtime Trains API is supported through user-provided credentials.

    • ⭐ 1
    • MCP
    • lucygoodchild/mcp-national-rail
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results