# Game Stats AI

> Game Stats AI is a game analytics platform for game studios of every size. Developers send match, player, character, achievement, and progression data to a REST API and get back hosted reports on player behavior, character balance, archetypes, achievements, and progression funnels.

Game Stats AI is built for game developers who want player analytics without building a data pipeline (the event collection, storage, and reporting infrastructure that analytics normally requires). You POST gameplay events to the JSON API and Game Stats AI generates attribute reports, character reports, player reports, archetype reports, achievement reports, and progression reports, with per-game (multi-tenant) accounts and API tokens.

## Pages

- [Home](https://gamestats.ai/): Product overview and feature summary
- [About](https://gamestats.ai/about): Who builds Game Stats AI
- [Contact](https://gamestats.ai/contact_us): Support contact

## API

Send game data to the JSON REST API and read analytics reports back. Authenticate every request with the `Authorization: Bearer <token>` header. Your API token and numeric account ID are on the API tokens page. Paths are under `/api/v1/...`.

- [Full API reference](https://gamestats.ai/llms-full.txt): every endpoint with parameters and copy-paste curl examples
- [OpenAPI spec (Swagger 2.0)](https://gamestats.ai/api-docs/v1/swagger.yaml): machine-readable source of truth
- [Interactive API docs](https://gamestats.ai/api-docs): browsable reference with request testing (JavaScript-rendered)
- [API tokens and account ID](https://gamestats.ai/api_tokens): create a token and find your account ID

### Key endpoints

- `POST /api/v1/accounts/{account_id}/achievement_events`: Creates an Achievement Event
- `POST /api/v1/accounts/{account_id}/achievement_images`: Create an Achievement Image
- `POST /api/v1/accounts/{account_id}/achievements`: Creates an Achievement
- `POST /api/v1/accounts/{account_id}/character_images`: Create a Character Image
- `POST /api/v1/accounts/{account_id}/characters`: Create a Character for a Version
- `POST /api/v1/accounts/{account_id}/events`: Creates an Event
- `POST /api/v1/accounts/{account_id}/matches`: Creates a Match
- `POST /api/v1/pings`: Pings the API
- `PATCH /api/v1/accounts/{account_id}/players/rename`: Rename a Player
- `POST /api/v1/accounts/{account_id}/progression_events`: Creates a Progression Event
- `GET /api/v1/accounts/{account_id}/*_reports`: read analytics reports (attribute, character, player, archetype, achievement, progression)

## MCP Server

Game Stats AI runs a hosted Model Context Protocol (MCP) server so AI assistants can read your analytics directly. Point an MCP client at `https://gamestats.ai/api/v1/mcp` and authenticate with the same `Authorization: Bearer <token>` header used for the REST API.

- Transport: Streamable HTTP (a single JSON-RPC POST endpoint), stateless.
- Tools are generated from the OpenAPI spec and are read-only: list and read every report type, list your accounts, look up the authenticated user, and ping the API. Data-import (write) endpoints are not exposed.
- The tool catalog is self-describing: call `tools/list` to get every tool name, description, and JSON input schema. Account-scoped tokens omit the `account_id` argument (it is inferred from the token).

## Blog

- [How to track achievements from a C# backend](https://gamestats.ai/blog/track-achievements-from-a-csharp-backend): Send achievement events to Game Stats AI from ASP.NET Core with a typed HttpClient, System.Text.Json records, and configuration-based secrets.
- [How to track achievements in a LÖVE 2D game](https://gamestats.ai/blog/track-achievements-in-a-love2d-game): A step-by-step guide to sending achievement events from a LÖVE 2D game using a JSON library, LÖVE 12's https module, and a worker thread to protect your frame rate.
- [Introducing Game Stats AI](https://gamestats.ai/blog/introducing-game-stats-ai): Game Stats AI turns gameplay events into actionable feedback for game developers. No data pipeline required.