How do I install HorizOn?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does HorizOn need an API key?

The publisher lists these environment variables: HORIZON_API_KEY, HORIZON_ACCOUNT_API_KEY, HORIZON_BASE_URL.

What transport does HorizOn use?

HorizOn runs locally over stdio.

When was HorizOn last checked?

Last checked 2026-11-09. Docs, live API tools and prompts for the horizOn game backend in Godot, Unity and Unreal.

HorizOn MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

HORIZON_API_KEY — horizOn project API key for the live API tools. The documentation works without it.
HORIZON_ACCOUNT_API_KEY — horizOn account key for the dashboard admin tools.
HORIZON_BASE_URL — API base URL.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1HORIZON_API_KEY=<secret> HORIZON_ACCOUNT_API_KEY=<secret> HORIZON_BASE_URL=<value> claude mcp add io.github.projectmakersde-horizon-mcp -- npx -y horizon-mcp@1.9.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.projectmakersde-horizon-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "HORIZON_API_KEY": "<secret>",11        "HORIZON_ACCOUNT_API_KEY": "<secret>",12        "HORIZON_BASE_URL": "<value>"13      }14    }15  }16}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.9.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

horizOn MCP Server

MCP server for horizOn Backend-as-a-Service

Gives AI coding assistants documentation, live API tools, and workflow prompts for game and app development.

Quick Install

Add to your MCP client configuration (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "horizOn": {
      "command": "npx",
      "args": ["-y", "horizon-mcp"],
      "env": {
        "HORIZON_API_KEY": "your-api-key-here"
      }
    }
  }
}

Features

Resources (18 docs)

Documentation resources are served directly from the MCP server. No API key required.

URI	Description
`horizon://overview`	What is horizOn, core concepts (Account vs User), features, tier system, API structure, and SDKs
`horizon://docs/auth`	Authentication methods (Anonymous, Email, Google), endpoints, SDK code examples, and common errors
`horizon://docs/leaderboard`	Leaderboard score submission, top entries, user rank, entries around user, player profile per entry, validated only boards, with SDK examples
`horizon://docs/cloud-save`	Cloud save/load for JSON and binary data, tier size limits, SDK examples
`horizon://docs/remote-config`	Server-side key-value configuration: feature flags, game balance, A/B testing. SDK examples
`horizon://docs/localization`	Server-side localized strings across 15 languages: per-key translations, single/all fetch, available languages. SDK examples
`horizon://docs/news`	In-game news and announcements with language filtering. SDK examples
`horizon://docs/gift-codes`	Gift code validation and redemption for promotional rewards, including cosmetic unlocks via grants. SDK examples
`horizon://docs/player-profile`	Player avatar, frame and badges from a per-project cosmetics catalog, unlocks via gift code grants, profile in leaderboard entries. SDK examples
`horizon://docs/validated-actions`	Server-checked runs: single-use run tickets with a server seed, SHA-256 input log hash, server-only rules, validated only leaderboards, server-owned player state, start context, evidence upload, admin evidence review with sus packages and package export, rejection codes. SDK examples
`horizon://docs/feedback`	Bug reports, feature requests, and general feedback submission. SDK examples
`horizon://docs/user-logs`	Server-side event and error tracking. Requires BASIC tier or higher. SDK examples
`horizon://docs/crash-reporting`	Crash report submission, session tracking, fingerprinting, breadcrumbs, and auto-regression detection. SDK examples
`horizon://docs/email-sending`

Tools (34 tools)

Live API tools that call the horizOn backend. Requires a valid API key.

horizon_submit_score, horizon_save_cloud_data, horizon_load_cloud_data, horizon_redeem_gift_code, horizon_get_profile, horizon_set_profile, horizon_start_run, horizon_submit_validated, horizon_get_state and horizon_upload_evidence also need the player's session: sign in first and pass the returned accessToken as sessionToken.

Every tool declares MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so clients can tell reads from writes. Destructive tools are horizon_save_cloud_data (replaces the save), horizon_set_profile (replaces the whole profile), horizon_submit_validated (consumes the ticket, can spend balances) and horizon_cancel_email. The read tools that return an object also declare an outputSchema and return structuredContent next to the JSON text. Each description names when to use the tool, which sibling to use instead, what it returns and how to recover from its errors.

Tool	Description
`horizon_test_connection`	Test connection to the horizOn API (health check)
`horizon_signup_anonymous`	Create a new anonymous user account
`horizon_signup_email`	Create a new user account with email and password
`horizon_signin_email`	Sign in with email and password
`horizon_signin_anonymous`	Sign in with an anonymous token
`horizon_check_auth`	Check whether a user session is still valid
`horizon_list_leaderboards`	List available leaderboard boards for multi-board calls
`horizon_submit_score`	Submit a score to the leaderboard (403 `VALIDATED_SUBMIT_REQUIRED` on validated only boards)
`horizon_get_leaderboard_top`	Get the top leaderboard entries with each player's profile, optionally by board key
`horizon_get_user_rank`	Get a user's leaderboard rank, optionally by board key
`horizon_get_leaderboard_around`	Get leaderboard entries around a user's position, optionally by board key
`horizon_save_cloud_data`	Save cloud data for a user, optionally only at an `expectedRevision` (409 on conflict)
`horizon_load_cloud_data`	Load cloud save data for a user, with its `revision`
`horizon_get_remote_config`	Get a single remote config value by key
`horizon_get_all_remote_configs`	Get all remote config values
`horizon_get_localization`	Get a single localized string by key, optionally for a specific language
`horizon_get_all_localizations`	Get all localized strings, optionally for a specific language
`horizon_get_localization_languages`	List the languages that have localizations for the app

Prompts (4 prompts)

Workflow prompts that guide AI assistants through common horizOn tasks.

Prompt	Description
`integrate-feature`	Generate integration code for a specific horizOn feature in your game engine
`setup-auth`	Step-by-step guide to set up horizOn authentication in your project
`debug-connection`	Diagnose and fix horizOn connection issues
`explain-feature`	Get a detailed explanation of any horizOn feature

Configuration

Variable	Required	Description
`HORIZON_API_KEY`	Yes (for tools)	Your horizOn API key. Get one at horizon.pm
`HORIZON_BASE_URL`	No	API base URL. Defaults to `https://horizon.pm`

Resources (documentation) work without an API key. Only the live API tools require authentication.

Admin Tools (v1.2+)

With an Account Key (creatable in your horizOn Dashboard -> API Keys -> Create -> Account Key), the MCP server exposes additional tools that let Claude manage your dashboard -- projects, remote config, news, email templates, gift codes, users, leaderboards, cloud-save data, crash reports, feedback, user logs, SMTP, and Validated Actions (rules, runs, player values and the evidence review).

How to get your Account Key

Log in to your horizOn Dashboard
Navigate to API Keys in the sidebar
Click Create API Key
Select Account Key as the key type
Choose whether the key can access the entire account, a single Project API Key, or selected feature groups
Click Create -- your key will be shown once. Copy it immediately.
Add the key to your MCP configuration (see Setup below)

Setup

Add both keys to your MCP client configuration:

{
  "mcpServers": {
    "horizOn": {
      "command": "npx",
      "args": ["-y", "horizon-mcp"],
      "env": {
        "HORIZON_API_KEY": "your-project-key (for player-facing tools)",
        "HORIZON_ACCOUNT_API_KEY": "your-account-key (for dashboard tools)"
      }
    }
  }
}

Both can be set together or individually. Admin tools only register when the account key is set -- otherwise the server exposes only the original player-facing tools.

Scope

Account Keys inherit your account's tier (FREE/BASIC/PRO/ENTERPRISE) -- they grant no extra privileges. A key can be full-account, limited to a single Project API Key, limited to selected feature groups, or both. Platform-admin-only endpoints (Blog, Banner, System-Config) are automatically unreachable. A handful of ultra-sensitive endpoints (account deletion, credentials change, key management itself, subscription cancel) require a dashboard session and cannot be called via an Account Key.

When a key is project-scoped, the backend enforces that scope on direct HTTP calls too. Account-wide endpoints or ID-only endpoints that cannot prove project context are rejected for project-scoped keys.

Tool Groups

Admin tools carry the same annotations as the player tools: list, get and statistics tools are read only, update and delete tools are marked destructive.

Prefix	Description
`horizon_admin_projects_*`	Project API key management (create/update/regenerate/revoke/delete)
`horizon_admin_remoteconfig_*`	Remote config CRUD
`horizon_admin_news_*`	Multilingual news (titles/messages as `{lang: content}`)
`horizon_admin_emailtemplates_*`	Multilingual email templates with variables
`horizon_admin_giftcodes_*`	Gift code CRUD + revoke
`horizon_admin_users_*`	User management + statistics (no full-list needed)
`horizon_admin_leaderboard_*`	Leaderboard entries + statistics
`horizon_admin_cloudsave_*`	Cloud save data + statistics
`horizon_admin_crashes_*`	Crash groups, reports, statistics
`horizon_admin_feedback_*`	Read user feedback
`horizon_admin_userlogs_*`	Read user logs
`horizon_admin_smtp_*`	Account SMTP configuration (password always returned masked)
`horizon_admin_validated_evidence_*`	Validated Actions evidence review: list (top N records or, with `sus: true`, sus packages), quota, metadata (with `susPackage`), log download (base64 or hashes only), package export (ZIP written to a local file, with the integrity headers), delete
`horizon_admin_validated_rules_`, `_usage_get`, `_runs_list`, `_state_`	Validated Actions configuration: rule set per Project API key (get, replace, delete), run capacity of the hour, recent runs with rejection codes (filter `sus`), server-owned player values (read, support correction)

What is horizOn?

horizOn is a multi-tenant Backend-as-a-Service platform built for game and app developers. It provides a managed backend so developers can focus on building their game or app instead of server infrastructure.

Core features:

Authentication (Anonymous, Email, Google, Apple)
Leaderboards
Cloud Save
Remote Config
Localization
News and Announcements
Gift Codes
Player Profile (avatar, frame, badges)
Validated Actions (server-checked runs, validated only leaderboards, server-owned currency)
User Feedback
User Logs
Crash Reporting
Email Sending

Learn more at horizon.pm. Install this MCP server via npm.

Supported Engines

Godot 4.5+ -- GDScript SDK
Unity 6 -- C# SDK
Unreal Engine 5.5+ -- C++ and Blueprint SDK

Development

# Clone the repository
git clone https://github.com/ProjectMakersDE/horizOn-mcp.git
cd horizOn-mcp

# Install dependencies
npm install

# Start the server (development mode)
npm run dev

# Build for production
npm run build

# Run tests
npm test

License

MIT