horizon-mcp 0.0.0-development

package/README.md

@@ -0,0 +1,138 @@
+# 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.):
+
+```json
+{
+  "mcpServers": {
+    "horizOn": {
+      "command": "npx",
+      "args": ["-y", "horizon-mcp"],
+      "env": {
+        "HORIZON_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+### Resources (13 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, 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/news` | In-game news and announcements with language filtering. SDK examples |
+| `horizon://docs/gift-codes` | Gift code validation and redemption for promotional rewards. 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://api/reference` | Complete API reference for all horizOn App API endpoints with request/response schemas |
+| `horizon://quickstart/godot` | Step-by-step guide to integrate horizOn in Godot with GDScript examples |
+| `horizon://quickstart/unity` | Step-by-step guide to integrate horizOn in Unity with C# examples |
+| `horizon://quickstart/unreal` | Guide to integrate horizOn in Unreal Engine using REST API. C++ and cURL examples |
+
+### Tools (19 tools)
+
+Live API tools that call the horizOn backend. Requires a valid API key.
+
+| 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_submit_score` | Submit a score to the leaderboard |
+| `horizon_get_leaderboard_top` | Get the top leaderboard entries |
+| `horizon_get_user_rank` | Get a user's leaderboard rank |
+| `horizon_get_leaderboard_around` | Get leaderboard entries around a user's position |
+| `horizon_save_cloud_data` | Save cloud data for a user |
+| `horizon_load_cloud_data` | Load cloud save data for a user |
+| `horizon_get_remote_config` | Get a single remote config value by key |
+| `horizon_get_all_remote_configs` | Get all remote config values |
+| `horizon_get_news` | Get news articles with optional language filtering |
+| `horizon_validate_gift_code` | Validate a gift code without redeeming it |
+| `horizon_redeem_gift_code` | Redeem a gift code for a user |
+| `horizon_submit_feedback` | Submit user feedback (bug reports, feature requests) |
+| `horizon_create_log` | Create a server-side log entry (INFO, WARN, ERROR) |
+
+### 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](https://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.
+
+## 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)
+- Leaderboards
+- Cloud Save
+- Remote Config
+- News and Announcements
+- Gift Codes
+- User Feedback
+- User Logs
+
+Learn more at [horizon.pm](https://horizon.pm).
+
+## Supported Engines
+
+- **Godot 4.5+** -- GDScript SDK
+- **Unity 6** -- C# SDK
+- **Unreal Engine** -- REST API (no official SDK)
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/nicokimmel/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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/prompts/debug-connection.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDebugConnectionPrompt(server: McpServer): void;
+//# sourceMappingURL=debug-connection.d.ts.map

package/dist/prompts/debug-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-connection.d.ts","sourceRoot":"","sources":["../../src/prompts/debug-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAerE"}

package/dist/prompts/debug-connection.js

@@ -0,0 +1,17 @@
+export function registerDebugConnectionPrompt(server) {
+    server.registerPrompt("debug-connection", {
+        title: "Debug horizOn Connection",
+        description: "Diagnose and fix horizOn connection issues.",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `My horizOn integration isn't working. Please help me debug the connection.\n\nSteps:\n1. Use the horizon_test_connection tool to check server reachability and API key validity\n2. If the connection fails, diagnose the issue:\n   - Is HORIZON_API_KEY set correctly?\n   - Is the server URL correct (default: https://horizon.pm)?\n   - Is there a network/firewall issue?\n3. If the connection succeeds but features fail, check:\n   - Is the user authenticated? (try horizon_check_auth)\n   - Are tier limits being hit? (check the feature docs for limits)\n   - Is rate limiting active? (10 requests/minute per client)\n4. Provide specific fixes for any issues found`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=debug-connection.js.map

package/dist/prompts/debug-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-connection.js","sourceRoot":"","sources":["../../src/prompts/debug-connection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE;QACxC,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,6CAA6C;KAC3D,EAAE,GAAG,EAAE,CAAC,CAAC;QACR,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,ypBAAypB;iBAChqB;aACF;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/prompts/explain-feature.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerExplainFeaturePrompt(server: McpServer): void;
+//# sourceMappingURL=explain-feature.d.ts.map

package/dist/prompts/explain-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-feature.d.ts","sourceRoot":"","sources":["../../src/prompts/explain-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BpE"}

package/dist/prompts/explain-feature.js

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+export function registerExplainFeaturePrompt(server) {
+    server.registerPrompt("explain-feature", {
+        title: "Explain horizOn Feature",
+        description: "Get a detailed explanation of any horizOn feature.",
+        argsSchema: {
+            feature: z
+                .enum([
+                "auth",
+                "leaderboard",
+                "cloud-save",
+                "remote-config",
+                "news",
+                "gift-codes",
+                "feedback",
+                "user-logs",
+            ])
+                .describe("The feature to explain"),
+        },
+    }, ({ feature }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Explain the horizOn "${feature}" feature in detail.\n\nPlease:\n1. Read the documentation (resource: horizon://docs/${feature})\n2. Explain what it does and when to use it\n3. Show the API endpoints and their parameters\n4. Provide code examples for Godot, Unity, and REST\n5. List tier limits and restrictions\n6. Share best practices and common pitfalls`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=explain-feature.js.map

package/dist/prompts/explain-feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-feature.js","sourceRoot":"","sources":["../../src/prompts/explain-feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE;QACvC,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE;YACV,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC;gBACJ,MAAM;gBACN,aAAa;gBACb,YAAY;gBACZ,eAAe;gBACf,MAAM;gBACN,YAAY;gBACZ,UAAU;gBACV,WAAW;aACZ,CAAC;iBACD,QAAQ,CAAC,wBAAwB,CAAC;SACtC;KACF,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACnB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,wBAAwB,OAAO,wFAAwF,OAAO,uOAAuO;iBAC5W;aACF;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers all horizOn MCP prompts on the given server.
+ */
+export declare function registerAllPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAK1D"}

package/dist/prompts/index.js

@@ -0,0 +1,14 @@
+import { registerIntegrateFeaturePrompt } from "./integrate-feature.js";
+import { registerSetupAuthPrompt } from "./setup-auth.js";
+import { registerDebugConnectionPrompt } from "./debug-connection.js";
+import { registerExplainFeaturePrompt } from "./explain-feature.js";
+/**
+ * Registers all horizOn MCP prompts on the given server.
+ */
+export function registerAllPrompts(server) {
+    registerIntegrateFeaturePrompt(server);
+    registerSetupAuthPrompt(server);
+    registerDebugConnectionPrompt(server);
+    registerExplainFeaturePrompt(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/prompts/integrate-feature.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerIntegrateFeaturePrompt(server: McpServer): void;
+//# sourceMappingURL=integrate-feature.d.ts.map

package/dist/prompts/integrate-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-feature.d.ts","sourceRoot":"","sources":["../../src/prompts/integrate-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiCtE"}

package/dist/prompts/integrate-feature.js

@@ -0,0 +1,35 @@
+import { z } from "zod/v4";
+export function registerIntegrateFeaturePrompt(server) {
+    server.registerPrompt("integrate-feature", {
+        title: "Integrate horizOn Feature",
+        description: "Generate integration code for a specific horizOn feature in your game engine.",
+        argsSchema: {
+            feature: z
+                .enum([
+                "auth",
+                "leaderboard",
+                "cloud-save",
+                "remote-config",
+                "news",
+                "gift-codes",
+                "feedback",
+                "user-logs",
+            ])
+                .describe("The horizOn feature to integrate"),
+            engine: z
+                .enum(["godot", "unity", "unreal"])
+                .describe("The game engine"),
+        },
+    }, ({ feature, engine }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I want to integrate the horizOn "${feature}" feature into my ${engine} project.\n\nPlease:\n1. Read the horizOn documentation for this feature (resource: horizon://docs/${feature})\n2. Read the ${engine} quickstart guide (resource: horizon://quickstart/${engine})\n3. Generate complete, production-ready integration code\n4. Include error handling and best practices\n5. Show how to test it works using the horizOn MCP tools\n\nUse the horizOn SDK for ${engine === "godot" ? "Godot (GDScript)" : engine === "unity" ? "Unity (C#)" : "Unreal Engine (REST/HTTP, no SDK)"}`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=integrate-feature.js.map

package/dist/prompts/integrate-feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-feature.js","sourceRoot":"","sources":["../../src/prompts/integrate-feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,cAAc,CAAC,mBAAmB,EAAE;QACzC,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+EAA+E;QACjF,UAAU,EAAE;YACV,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC;gBACJ,MAAM;gBACN,aAAa;gBACb,YAAY;gBACZ,eAAe;gBACf,MAAM;gBACN,YAAY;gBACZ,UAAU;gBACV,WAAW;aACZ,CAAC;iBACD,QAAQ,CAAC,kCAAkC,CAAC;YAC/C,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;iBAClC,QAAQ,CAAC,iBAAiB,CAAC;SAC/B;KACF,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,oCAAoC,OAAO,qBAAqB,MAAM,sGAAsG,OAAO,kBAAkB,MAAM,qDAAqD,MAAM,iMAAiM,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,mCAAmC,EAAE;iBACjkB;aACF;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/prompts/setup-auth.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSetupAuthPrompt(server: McpServer): void;
+//# sourceMappingURL=setup-auth.d.ts.map

package/dist/prompts/setup-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-auth.d.ts","sourceRoot":"","sources":["../../src/prompts/setup-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwB/D"}

package/dist/prompts/setup-auth.js

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+export function registerSetupAuthPrompt(server) {
+    server.registerPrompt("setup-auth", {
+        title: "Setup Authentication",
+        description: "Step-by-step guide to set up horizOn authentication in your project.",
+        argsSchema: {
+            engine: z
+                .enum(["godot", "unity", "unreal"])
+                .describe("Your game engine"),
+            method: z
+                .enum(["anonymous", "email", "google"])
+                .describe("Authentication method"),
+        },
+    }, ({ engine, method }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Set up horizOn ${method} authentication in my ${engine} project.\n\nPlease:\n1. Read the auth documentation (resource: horizon://docs/auth)\n2. Read the ${engine} quickstart (resource: horizon://quickstart/${engine})\n3. Walk me through the setup step by step\n4. Provide complete code for signup AND signin flows\n5. Include token storage/caching\n6. Show error handling for common issues (invalid credentials, network errors, rate limits)\n7. Test the flow using horizOn MCP tools`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=setup-auth.js.map

package/dist/prompts/setup-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-auth.js","sourceRoot":"","sources":["../../src/prompts/setup-auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE;QAClC,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,sEAAsE;QACxE,UAAU,EAAE;YACV,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;iBAClC,QAAQ,CAAC,kBAAkB,CAAC;YAC/B,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACtC,QAAQ,CAAC,uBAAuB,CAAC;SACrC;KACF,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,kBAAkB,MAAM,yBAAyB,MAAM,qGAAqG,MAAM,+CAA+C,MAAM,6QAA6Q;iBAC3e;aACF;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers all horizOn documentation resources on the given server.
+ */
+export declare function registerAllResources(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BpE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiR5D"}

package/dist/resources/index.js

@@ -0,0 +1,208 @@
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Resolves the docs base directory. When running from src/ the markdown files
+ * sit next to this module. When running from dist/ we look in src/resources/.
+ */
+function getDocsBase() {
+    // Check if MD files live alongside the compiled module (dev / src)
+    if (existsSync(join(__dirname, "docs", "overview.md"))) {
+        return __dirname;
+    }
+    // Fallback: resolve from project root into src/resources (production / dist)
+    return join(__dirname, "..", "..", "src", "resources");
+}
+const docsBase = getDocsBase();
+function loadDoc(relativePath) {
+    return readFileSync(join(docsBase, relativePath), "utf-8");
+}
+/**
+ * Registers all horizOn documentation resources on the given server.
+ */
+export function registerAllResources(server) {
+    // Overview
+    server.registerResource("overview", "horizon://overview", {
+        title: "horizOn Overview",
+        description: "What is horizOn, core concepts (Account vs User), features, tier system, API structure, and SDKs.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://overview",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/overview.md"),
+            },
+        ],
+    }));
+    // Authentication
+    server.registerResource("docs-auth", "horizon://docs/auth", {
+        title: "Authentication",
+        description: "Authentication methods (Anonymous, Email, Google), endpoints, SDK code examples, and common errors.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/auth",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/auth.md"),
+            },
+        ],
+    }));
+    // Leaderboards
+    server.registerResource("docs-leaderboard", "horizon://docs/leaderboard", {
+        title: "Leaderboards",
+        description: "Leaderboard score submission, top entries, user rank, entries around user, with SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/leaderboard",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/leaderboard.md"),
+            },
+        ],
+    }));
+    // Cloud Save
+    server.registerResource("docs-cloud-save", "horizon://docs/cloud-save", {
+        title: "Cloud Save",
+        description: "Cloud save/load for JSON and binary data, tier size limits, SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/cloud-save",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/cloud-save.md"),
+            },
+        ],
+    }));
+    // Remote Config
+    server.registerResource("docs-remote-config", "horizon://docs/remote-config", {
+        title: "Remote Config",
+        description: "Server-side key-value configuration: feature flags, game balance, A/B testing. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/remote-config",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/remote-config.md"),
+            },
+        ],
+    }));
+    // News
+    server.registerResource("docs-news", "horizon://docs/news", {
+        title: "News",
+        description: "In-game news and announcements with language filtering. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/news",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/news.md"),
+            },
+        ],
+    }));
+    // Gift Codes
+    server.registerResource("docs-gift-codes", "horizon://docs/gift-codes", {
+        title: "Gift Codes",
+        description: "Gift code validation and redemption for promotional rewards. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/gift-codes",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/gift-codes.md"),
+            },
+        ],
+    }));
+    // Feedback
+    server.registerResource("docs-feedback", "horizon://docs/feedback", {
+        title: "User Feedback",
+        description: "Bug reports, feature requests, and general feedback submission. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/feedback",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/feedback.md"),
+            },
+        ],
+    }));
+    // User Logs
+    server.registerResource("docs-user-logs", "horizon://docs/user-logs", {
+        title: "User Logs",
+        description: "Server-side event and error tracking. Requires BASIC tier or higher. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/user-logs",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/user-logs.md"),
+            },
+        ],
+    }));
+    // API Reference
+    server.registerResource("api-reference", "horizon://api/reference", {
+        title: "App API Reference",
+        description: "Complete API reference for all horizOn App API endpoints with request/response schemas.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://api/reference",
+                mimeType: "text/markdown",
+                text: loadDoc("api/app-api.md"),
+            },
+        ],
+    }));
+    // Quickstart: Godot
+    server.registerResource("quickstart-godot", "horizon://quickstart/godot", {
+        title: "Godot Quickstart",
+        description: "Step-by-step guide to integrate horizOn in Godot with GDScript examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://quickstart/godot",
+                mimeType: "text/markdown",
+                text: loadDoc("quickstart/godot.md"),
+            },
+        ],
+    }));
+    // Quickstart: Unity
+    server.registerResource("quickstart-unity", "horizon://quickstart/unity", {
+        title: "Unity Quickstart",
+        description: "Step-by-step guide to integrate horizOn in Unity with C# examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://quickstart/unity",
+                mimeType: "text/markdown",
+                text: loadDoc("quickstart/unity.md"),
+            },
+        ],
+    }));
+    // Quickstart: Unreal
+    server.registerResource("quickstart-unreal", "horizon://quickstart/unreal", {
+        title: "Unreal Engine Quickstart",
+        description: "Guide to integrate horizOn in Unreal Engine using REST API (no official SDK). C++ and cURL examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://quickstart/unreal",
+                mimeType: "text/markdown",
+                text: loadDoc("quickstart/unreal.md"),
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,YAAY,IAAI,SAAS,CAWxC"}

package/dist/server.js

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerAllResources } from "./resources/index.js";
+import { registerAllTools } from "./tools/index.js";
+import { registerAllPrompts } from "./prompts/index.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "horizon-mcp",
+        version: "0.1.0",
+    });
+    registerAllResources(server);
+    registerAllTools(server);
+    registerAllPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/__tests__/api-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-client.test.d.ts.map

package/dist/tools/__tests__/api-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/api-client.test.ts"],"names":[],"mappings":""}