Halo Infinite MCP

OpenSpartan Forerunner is a local MCP server used to connect to Halo Infinite game data, supporting access to game information such as player battle records and equipment configurations through MCP clients.

Games and gamification Developer tools #Game data #Local service #Halo tool .C#

rating : 2 points

downloads : 15

update time : 2025-04-29

What is OpenSpartan Forerunner?

Forerunner is a locally - running MCP server that acts as a bridge, allowing you to access Halo Infinite game data through a compatible client. It emulates the official server protocol, enabling you to safely query your personal game data.

How to use Forerunner?

Simply download the executable file, configure your MCP client to point to this service, and then query your Halo Infinite data through supported client tools.

Use cases

Suitable for players who want to query Halo Infinite game data through AI assistants or development tools, including scenarios such as querying battle records, viewing equipment configurations, and browsing store items.

Main features

Game data accessProvides access to various types of Halo Infinite game data, including player battle records, match histories, and equipment configurations, etc.

Local operationThe server runs entirely on the user's local machine, ensuring data privacy and security.

Multi - client supportSupports multiple MCP clients such as Visual Studio Code Insiders and Claude Desktop.

Advantages and limitations

Advantages

Runs entirely locally, ensuring data security

Supports multiple client tools

Provides rich game data query functions

Limitations

Currently in the alpha stage, and the functions may be unstable

Requires the.NET 9 SDK runtime environment

Only supports Halo Infinite game data

How to use

Download and install

Download the latest version from the GitHub release page and extract it.

Configure the client

Update your MCP client configuration to point to the extracted OpenSpartan.Forerunner.MCP.exe file.

Authentication

Usage examples

Query match recordsView the results and performance data of the latest 10 matches

Check equipment configurationView the current character's armor and appearance configuration

Frequently Asked Questions

Is my account information secure?

Why do I need Visual Studio Code Insiders?

How often is the data updated?

Related resources

GitHub repository

Project source code and latest releases

.NET 9 SDK

Download the.NET 9 SDK required for running

Visual Studio Code Insiders

Code editor that supports MCP

🚀 Getting Started with OpenSpartan Forerunner

Forerunner is a custom-built local MCP server that allows you to connect to your Halo Infinite data via any MCP client you use.

⚠️ Important Note

This tool is currently in the alpha stage as the MCP protocol is still under development (and so is Forerunner). Use it with caution.

🚀 Quick Start

Prerequisites

.NET 9 SDK

Steps

Download the latest version.
Extract the files to your local device.
Update your MCP client configuration to point to OpenSpartan.Forerunner.MCP.exe and use the dotnet command as the bootstrapping tool.

Example Configurations

Visual Studio Code

⚠️ Important Note

You need to install Visual Studio Code Insiders to support MCP.

"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

After adding the tool to your MCP client, you'll be prompted to enter your Microsoft Account (MSA) credentials. This is the Xbox Live account you use for Halo Infinite. During this process, no tokens or other credentials will leave your device. They will be cached locally and used only for communicating with the Xbox and Halo Infinite REST APIs.

✨ Features

Property	Details
`opsp_api_endpoints`	Returns a JSON list of all available endpoints for the Halo Infinite REST API.
`opsp_my_service_record`	Returns the complete Halo Infinite service record (for matchmade games only) of the authenticated player. This tool does not include career rank information.
`opsp_my_latest_matches`	Returns the statistics of the player's latest Halo Infinite battles, including all types of games (e.g., matchmade games, custom games, and LAN games). All returned match dates are in UTC format.
`opsp_exchange_list`	Lists all items currently available in the Halo Infinite Exchange.
`opsp_my_gear_configuration`	Returns the Halo Infinite custom settings and their images for the authenticated user.
`opsp_my_career_rank`	Returns the player's current Halo Infinite career rank (or level) and the progress towards the highest level (Hero). Players gain experience through each match and may want to know how long it will take to reach the Hero rank.