kali-afl
get api key →

Claude / MCP

Connect Claude directly to the AFL database with the Kali MCP server. Ask football questions in plain English — Claude writes the SQL, runs it read-only, and answers from the results. No queries to write yourself.

What it does

Once connected, just ask. For example:

  • "Which team had the highest average crowd in 2024?"
  • "Show me the top 10 goal-kickers across the last three rounds."
  • "Compare Geelong's home vs away win rate since 2016."

It's read-only (Claude can only SELECT), uses the same API key and daily quota as the REST API, and can only see AFL data — never user accounts or keys.

Setup

1. Get an API key

Create one on the API Usage page after signing in. It's shown once — copy it straight away. Get a free API key →

2. Add the server

Claude Code

claude mcp add --transport http kali-afl \
  https://kali-afl-mcp-173366351243.australia-southeast1.run.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Edit your Claude Desktop config file — on macOS ~/Library/Application Support/Claude/claude_desktop_config.json, on Windows %APPDATA%\Claude\claude_desktop_config.json. Create it if it doesn't exist:

{
  "mcpServers": {
    "kali-afl": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://kali-afl-mcp-173366351243.australia-southeast1.run.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

If the file already has an mcpServers block, add the kali-afl entry alongside your existing servers rather than replacing them. Then fully quit and reopen Claude Desktop — reloading the window isn't enough.

3. Verify

claude mcp list

You should see kali-afl connected. In Claude Desktop, reopen the app and look for kali-afl in the tools menu under the message box. Then just ask Claude an AFL question.

Supported clients

This is a remote server that uses the HTTP transport. Claude Code connects to it directly. Claude Desktop only speaks to local (stdio) servers, so the config above routes it through mcp-remote — a small bridge that runs on your machine and forwards to the server over HTTP. That means Desktop also needs Node.js installed, since the bridge is launched with npx.

Good to know

  • Read-only. Claude can never change or delete data.
  • Quota. Each query counts against your daily limit; it resets at midnight UTC. Browsing the schema is free.
  • Row cap. A single query returns up to 1,000 rows — ask Claude to aggregate for larger sets.

Ready to connect Claude?

get a free api key →