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?