halo-infinite-mcp

Forerunner is a custom-built local MCP server that allows you to connect to your Halo Infinite data through whatever MCP client you're using.

>[!WARNING]

>This is a alpha-quality tool at this point, as the MCP protocol is being fleshed out (and so is Forerunner). Here be dragons.

Prerequisites

• .NET 9 SDK

Get started

1. Download the latest release.

1. Extract the package locally.

1. Update your MCP client configuration to point to the `OpenSpartan.Forerunner.MCP.exe` with the `dotnet` command as the bootstrap tool.

Example configurations

Visual Studio Code

>[!IMPORTANT]

>You will need to install Visual Studio Code Insiders for MCP support.

"mcp": {
    "inputs": [],
    "servers": {
        "mcp-halo-infinite": {
            "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",
            "args": [],
            "env": {}
        }
    }
}

Claude Desktop

"mcpServers": {
    "mcp-halo-infinite": {
        "command": "PATH_TO_YOUR_OpenSpartan.Forerunner.MCP.exe",
        "args": [],
        "env": {}
    }
}

Authentication

Once you add the tool to your MCP client, you will be prompted for your Microsoft Account (MSA) credentials. This is your Xbox Live account that you use for Halo Infinite. No tokens (or any other credentials artifacts) ever leave your machine during this process. They are cached locally and then used to talk exclusively to Xbox and Halo Infinite REST APIs - nothing else.

Supported tools

>[!IMPORTANT]

>I am constantly adding new tools. This table will be updated as new ones are introduced.

Running

Some questions you can ask:

1. What are my latest stats for matchmade games?

1. What were the outcomes for my last 10 matches?

1. What is my current armor configuration?

1. What’s currently available on sale through The Exchange?

1. What’s my current career rank?