OpenSpartan Forerunner

By dend GitHub

🪐 MCP server for Halo Infinite.

mcp halo

Overview

What is OpenSpartan Forerunner?

OpenSpartan Forerunner is a custom-built local MCP server that connects users to Halo Infinite data through various MCP clients.

How to use OpenSpartan Forerunner?

To use OpenSpartan Forerunner, download the latest release, extract the package, and configure your MCP client to point to the OpenSpartan.Forerunner.MCP.exe using the dotnet command.

Key features of OpenSpartan Forerunner?

Connects to Halo Infinite data via MCP clients.
Supports various tools for accessing Halo Infinite REST API endpoints.
Provides player service records, match stats, and gear configurations.

Use cases of OpenSpartan Forerunner?

Retrieve latest stats for matchmade games.
Access career rank and progress in Halo Infinite.
Query available items on the Halo Infinite exchange.

FAQ from OpenSpartan Forerunner?

Is OpenSpartan Forerunner stable?

It is currently in alpha quality, and users should be cautious as the MCP protocol is still being developed.

Do I need a Microsoft Account to use it?

Yes, you will need your Xbox Live account credentials for authentication, but no tokens leave your machine.

Content

OpenSpartan Forerunner

MCP server connecting you to Halo Infinite data.

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

Download the latest release.
Extract the package locally.
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.