OpenSpartan Forerunner

<div align="center"> <img src="media/forerunner-logo.webp" width="200" height="200"> <h1>OpenSpartan Forerunner</h1> <p> <b>MCP server connecting you to Halo Infinite data.</b> </p> <br> <br> <br> </div>

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.
2. Extract the package locally.
3. 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.

Tool Name	Description
opsp_api_endpoints	Returns a JSON-formatted list of all available endpoints that exist in the Halo Infinite REST API surface.
opsp_my_service_record	Returns the complete Halo Infinite player service record for matchmade games for the currently authenticated player. This tool does not have the career rank.
opsp_my_latest_matches	Returns the stats for a player's latest Halo Infinite matches. This includes all match types, such as matchmade games, custom games, and LAN games. All match dates returned in UTC.
opsp_exchange_list	Lists all of the items that are currently available on the Halo Infinite exchange.
opsp_my_gear_configuration	Returns Halo Infinite customizations with their images for the authenticated user.
opsp_my_career_rank	Returns the player's current Halo Infinite career rank (or level) and progress to the top level (Hero). The player earns experience with every match and might want to know how long until Hero rank.

Running

Some questions you can ask:

1. What are my latest stats for matchmade games?
2. What were the outcomes for my last 10 matches?
3. What is my current armor configuration?
4. What’s currently available on sale through The Exchange?
5. What’s my current career rank?