horizon-mcp 1.1.0 → 1.3.0

package/README.md

@@ -94,6 +94,62 @@ Workflow prompts that guide AI assistants through common horizOn tasks.
 
 Resources (documentation) work without an API key. Only the live API tools require authentication.
 
+## Admin Tools (v1.2+)
+
+With an **Account-API-Key** (creatable in your horizOn Dashboard -> API Keys -> Create -> **MCP Account Key**), the MCP server exposes additional tools that let Claude manage your entire dashboard -- projects, remote config, news, email templates, gift codes, users, leaderboards, cloud-save data, crash reports, feedback, user logs, and SMTP.
+
+### How to get your Account API Key
+
+1. Log in to your [horizOn Dashboard](https://horizon.pm/dashboard)
+2. Navigate to **API Keys** in the sidebar
+3. Click **Create API Key**
+4. Select **MCP Account Key** as the key type
+5. Give your key a name (e.g. "My MCP Server")
+6. Click **Create** -- your key will be shown **once**. Copy it immediately.
+7. Add the key to your MCP configuration (see Setup below)
+
+### Setup
+
+Add both keys to your MCP client configuration:
+
+```json
+{
+  "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
+
+Admin tools inherit your account's tier (FREE/BASIC/PRO/ENTERPRISE) -- they grant no extra privileges. 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 the account key.
+
+### Tool Groups
+
+| 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) |
+
 ## 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.

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

@@ -1 +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,CAsS5D"}
+{"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,CA2T5D"}

package/dist/resources/index.js

@@ -204,6 +204,20 @@ export function registerAllResources(server) {
             },
         ],
     }));
+    // Email Sending
+    server.registerResource("docs-email-sending", "horizon://docs/email-sending", {
+        title: "Email Sending",
+        description: "Transactional and event-based email delivery to registered users. Templates, scheduling, status tracking, and SMTP integration. SDK examples.",
+        mimeType: "text/markdown",
+    }, () => ({
+        contents: [
+            {
+                uri: "horizon://docs/email-sending",
+                mimeType: "text/markdown",
+                text: loadDoc("docs/email-sending.md"),
+            },
+        ],
+    }));
     // Quickstart: Unreal
     server.registerResource("quickstart-unreal", "horizon://quickstart/unreal", {
         title: "Unreal Engine Quickstart",

package/dist/resources/index.js.map

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

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

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

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

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

package/dist/tools/__tests__/admin-api-client.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect, afterEach, vi } from "vitest";
+import { createAdminApiClientFromEnv } from "../admin-api-client.js";
+import { HorizonApiClient } from "../api-client.js";
+function mockFetchResponse(body, init) {
+    const status = init?.status ?? 200;
+    const ok = init?.ok ?? (status >= 200 && status < 300);
+    return vi.fn().mockResolvedValue({
+        ok,
+        status,
+        json: async () => body,
+        text: async () => (typeof body === "string" ? body : JSON.stringify(body)),
+    });
+}
+describe("createAdminApiClientFromEnv", () => {
+    const originalKey = process.env.HORIZON_ACCOUNT_API_KEY;
+    const originalUrl = process.env.HORIZON_BASE_URL;
+    afterEach(() => {
+        if (originalKey !== undefined) {
+            process.env.HORIZON_ACCOUNT_API_KEY = originalKey;
+        }
+        else {
+            delete process.env.HORIZON_ACCOUNT_API_KEY;
+        }
+        if (originalUrl !== undefined) {
+            process.env.HORIZON_BASE_URL = originalUrl;
+        }
+        else {
+            delete process.env.HORIZON_BASE_URL;
+        }
+        vi.unstubAllGlobals();
+    });
+    it("returns null without HORIZON_ACCOUNT_API_KEY", () => {
+        delete process.env.HORIZON_ACCOUNT_API_KEY;
+        expect(createAdminApiClientFromEnv()).toBeNull();
+    });
+    it("returns a HorizonApiClient when HORIZON_ACCOUNT_API_KEY is set", () => {
+        process.env.HORIZON_ACCOUNT_API_KEY = "test";
+        const client = createAdminApiClientFromEnv();
+        expect(client).not.toBeNull();
+        expect(client).toBeInstanceOf(HorizonApiClient);
+    });
+    it("uses X-Account-API-Key header for requests", async () => {
+        process.env.HORIZON_ACCOUNT_API_KEY = "test-key";
+        process.env.HORIZON_BASE_URL = "https://example.com";
+        const fakeFetch = mockFetchResponse({ ok: true });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = createAdminApiClientFromEnv();
+        await client.get("/api/v1/admin/ping");
+        expect(fakeFetch).toHaveBeenCalledTimes(1);
+        const [url, options] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://example.com/api/v1/admin/ping");
+        expect(options.headers["X-Account-API-Key"]).toBe("test-key");
+        expect(options.headers["X-API-Key"]).toBeUndefined();
+        expect(options.headers["Content-Type"]).toBe("application/json");
+    });
+    it("defaults baseUrl to https://horizon.pm", async () => {
+        process.env.HORIZON_ACCOUNT_API_KEY = "k";
+        delete process.env.HORIZON_BASE_URL;
+        const fakeFetch = mockFetchResponse({});
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = createAdminApiClientFromEnv();
+        await client.get("/api/v1/admin/ping");
+        const [url] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://horizon.pm/api/v1/admin/ping");
+    });
+});
+//# sourceMappingURL=admin-api-client.test.js.map

package/dist/tools/__tests__/admin-api-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-api-client.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/admin-api-client.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/admin-e2e.test.d.ts

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

package/dist/tools/__tests__/admin-e2e.test.d.ts.map

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

package/dist/tools/__tests__/admin-e2e.test.js

@@ -0,0 +1,19 @@
+import { describe, it, expect } from "vitest";
+import { createAdminApiClientFromEnv } from "../admin-api-client.js";
+const hasEnv = !!process.env.HORIZON_ACCOUNT_API_KEY;
+describe.skipIf(!hasEnv)("admin api e2e", () => {
+    it("GET /admin/api-keys with keyType=PROJECT returns successfully", async () => {
+        const client = createAdminApiClientFromEnv();
+        const result = await client.get("/api/v1/admin/api-keys", {
+            keyType: "PROJECT",
+            size: "1",
+        });
+        expect(result).toBeDefined();
+    });
+    it("GET /admin/user-management/statistics returns stats shape", async () => {
+        const client = createAdminApiClientFromEnv();
+        const result = (await client.get("/api/v1/admin/user-management/statistics"));
+        expect(result).toHaveProperty("totalUsers");
+    });
+});
+//# sourceMappingURL=admin-e2e.test.js.map

package/dist/tools/__tests__/admin-e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-e2e.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/admin-e2e.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AAErD,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,MAAM,GAAG,2BAA2B,EAAG,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,wBAAwB,EAAE;YACxD,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAG,2BAA2B,EAAG,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAC9B,0CAA0C,CAC3C,CAAQ,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/admin/_utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared helpers for admin-tool handlers.
+ *
+ * These mirror the player-side helpers in ../tool-helpers.ts but tailored
+ * for the account-key surface:
+ *
+ *  - getAdminClient()        — lazy factory, returns null when unconfigured
+ *  - noAdminClientResponse() — consistent error when the key is missing
+ *  - jsonResponse()          — pretty-print arbitrary JSON payloads
+ *  - errorResponse()         — surface thrown errors to the caller
+ */
+type ToolContent = {
+    type: "text";
+    text: string;
+};
+type ToolResult = {
+    content: ToolContent[];
+    isError?: boolean;
+};
+export declare function getAdminClient(): import("../api-client.js").HorizonApiClient | null;
+export declare function noAdminClientResponse(): ToolResult;
+export declare function jsonResponse<T>(data: T): ToolResult;
+export declare function errorResponse(error: unknown): ToolResult;
+export {};
+//# sourceMappingURL=_utils.d.ts.map

package/dist/tools/admin/_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE,wBAAgB,cAAc,uDAE7B;AAED,wBAAgB,qBAAqB,IAAI,UAAU,CAWlD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CASnD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAmBxD"}

package/dist/tools/admin/_utils.js

@@ -0,0 +1,59 @@
+/**
+ * Shared helpers for admin-tool handlers.
+ *
+ * These mirror the player-side helpers in ../tool-helpers.ts but tailored
+ * for the account-key surface:
+ *
+ *  - getAdminClient()        — lazy factory, returns null when unconfigured
+ *  - noAdminClientResponse() — consistent error when the key is missing
+ *  - jsonResponse()          — pretty-print arbitrary JSON payloads
+ *  - errorResponse()         — surface thrown errors to the caller
+ */
+import { createAdminApiClientFromEnv } from "../admin-api-client.js";
+import { HorizonApiError } from "../api-client.js";
+export function getAdminClient() {
+    return createAdminApiClientFromEnv();
+}
+export function noAdminClientResponse() {
+    return {
+        content: [
+            {
+                type: "text",
+                text: "HORIZON_ACCOUNT_API_KEY is not configured. Admin tools require an account-level API key.",
+            },
+        ],
+        isError: true,
+    };
+}
+export function jsonResponse(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function errorResponse(error) {
+    let message;
+    if (error instanceof HorizonApiError) {
+        message = `horizOn API error (HTTP ${error.status}): ${error.body}`;
+    }
+    else if (error instanceof Error) {
+        message = `Error: ${error.message}`;
+    }
+    else {
+        message = `Unknown error: ${String(error)}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: message,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=_utils.js.map

package/dist/tools/admin/_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.js","sourceRoot":"","sources":["../../../src/tools/admin/_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,UAAU,cAAc;IAC5B,OAAO,2BAA2B,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,0FAA0F;aAC7F;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,IAAO;IACrC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAe,CAAC;IACpB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,GAAG,2BAA2B,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,GAAG,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,OAAO;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/admin/cloud-save.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Admin tools for managing cloud saves.
+ *
+ * Cloud saves are per-user, per-project blobs produced by the runtime
+ * app's save API. These tools wrap the /api/v1/admin/cloud-save
+ * endpoints so callers can list, fetch, update, delete and inspect
+ * statistics/limits from the MCP surface.
+ *
+ * All tools require HORIZON_ACCOUNT_API_KEY.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdminCloudSaveTools(server: McpServer): void;
+//# sourceMappingURL=cloud-save.d.ts.map

package/dist/tools/admin/cloud-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-save.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/cloud-save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkLnE"}

package/dist/tools/admin/cloud-save.js

@@ -0,0 +1,154 @@
+/**
+ * Admin tools for managing cloud saves.
+ *
+ * Cloud saves are per-user, per-project blobs produced by the runtime
+ * app's save API. These tools wrap the /api/v1/admin/cloud-save
+ * endpoints so callers can list, fetch, update, delete and inspect
+ * statistics/limits from the MCP surface.
+ *
+ * All tools require HORIZON_ACCOUNT_API_KEY.
+ */
+import { z } from "zod/v4";
+import { getAdminClient, noAdminClientResponse, jsonResponse, errorResponse, } from "./_utils.js";
+export function registerAdminCloudSaveTools(server) {
+    server.registerTool("horizon_admin_cloudsave_list", {
+        title: "List Cloud Saves",
+        description: "Lists cloud saves for the authenticated account, optionally filtered by project API key. Default sort is createdAt DESC.",
+        inputSchema: {
+            projectApiKeyId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Optional UUID of the project API key to filter saves by"),
+            page: z.number().int().min(0).default(0).describe("0-based page index"),
+            size: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe("items per page (1-100)"),
+        },
+    }, async ({ projectApiKeyId, page, size }) => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const params = {
+                page: String(page),
+                size: String(size),
+            };
+            if (projectApiKeyId !== undefined)
+                params.apiKeyId = projectApiKeyId;
+            const result = await client.get("/api/v1/admin/cloud-save", params);
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+    server.registerTool("horizon_admin_cloudsave_get", {
+        title: "Get Cloud Save",
+        description: "Fetches a single cloud save by its UUID, including the full saveData payload.",
+        inputSchema: {
+            id: z.string().uuid().describe("UUID of the cloud save to fetch"),
+        },
+    }, async ({ id }) => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const result = await client.get(`/api/v1/admin/cloud-save/${id}`);
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+    server.registerTool("horizon_admin_cloudsave_update", {
+        title: "Update Cloud Save",
+        description: "Replaces the saveData of an existing cloud save. The backend enforces both a hard 300KB request limit and a soft per-tier byte limit.",
+        inputSchema: {
+            id: z.string().uuid().describe("UUID of the cloud save to update"),
+            data: z
+                .string()
+                .min(1)
+                .max(300000)
+                .describe("New save data (plain string or Base64, <= 300000 chars / ~300KB)"),
+        },
+    }, async ({ id, data }) => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const result = await client.put(`/api/v1/admin/cloud-save/${id}`, { saveData: data });
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+    server.registerTool("horizon_admin_cloudsave_delete", {
+        title: "Delete Cloud Save",
+        description: "Soft-deletes a cloud save. Deleted saves are no longer accessible to end-users and disappear from list results.",
+        inputSchema: {
+            id: z.string().uuid().describe("UUID of the cloud save to delete"),
+        },
+    }, async ({ id }) => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const result = await client.delete(`/api/v1/admin/cloud-save/${id}`);
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+    server.registerTool("horizon_admin_cloudsave_getStats", {
+        title: "Get Cloud Save Statistics",
+        description: "Returns aggregated cloud save statistics for the authenticated account (totals, storage used in bytes/KB/MB, average size, per-project breakdown). Note: the current backend endpoint is account-scoped; projectApiKeyId is reserved for forward-compat.",
+        inputSchema: {
+            projectApiKeyId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Optional UUID of the project API key. Currently ignored by the backend; kept for forward-compat."),
+        },
+    }, async () => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const result = await client.get("/api/v1/admin/cloud-save/statistics");
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+    server.registerTool("horizon_admin_cloudsave_getLimits", {
+        title: "Get Cloud Save Limits",
+        description: "Returns the cloud save limits and current usage for the authenticated account (role, max bytes per save, current count, current storage used). Note: the current backend endpoint is account-scoped; projectApiKeyId is reserved for forward-compat.",
+        inputSchema: {
+            projectApiKeyId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Optional UUID of the project API key. Currently ignored by the backend; kept for forward-compat."),
+        },
+    }, async () => {
+        const client = getAdminClient();
+        if (!client)
+            return noAdminClientResponse();
+        try {
+            const result = await client.get("/api/v1/admin/cloud-save/limits");
+            return jsonResponse(result);
+        }
+        catch (e) {
+            return errorResponse(e);
+        }
+    });
+}
+//# sourceMappingURL=cloud-save.js.map

package/dist/tools/admin/cloud-save.js.map

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

package/dist/tools/admin/crashes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Admin tools for crash reporting.
+ *
+ * Crash reports are grouped by a deduplication hash on the backend so
+ * "crash groups" represent unique crash signatures with many
+ * occurrences. These tools wrap the /api/v1/admin/crash-reports
+ * endpoints and cover:
+ *   - listing and fetching crash groups
+ *   - updating group status and notes
+ *   - listing occurrences per group
+ *   - fetching a specific report
+ *   - account-level stats
+ *   - deleting a group (soft delete)
+ *
+ * All tools require HORIZON_ACCOUNT_API_KEY.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAdminCrashesTools(server: McpServer): void;
+//# sourceMappingURL=crashes.d.ts.map

package/dist/tools/admin/crashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashes.d.ts","sourceRoot":"","sources":["../../../src/tools/admin/crashes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsRjE"}