horizon-mcp 0.0.0-development

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

@@ -0,0 +1,156 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { HorizonApiClient, HorizonApiError, createApiClientFromEnv, } from "../api-client.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+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),
+    });
+}
+// ---------------------------------------------------------------------------
+// HorizonApiClient
+// ---------------------------------------------------------------------------
+describe("HorizonApiClient", () => {
+    const originalFetch = globalThis.fetch;
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it("throws if no API key is provided", () => {
+        expect(() => new HorizonApiClient("", "https://example.com")).toThrow("API key must not be empty");
+    });
+    it("GET sends X-API-Key header", async () => {
+        const fakeFetch = mockFetchResponse({ ok: true });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("test-key", "https://example.com");
+        await client.get("/api/v1/test");
+        expect(fakeFetch).toHaveBeenCalledTimes(1);
+        const [url, options] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://example.com/api/v1/test");
+        expect(options.method).toBe("GET");
+        expect(options.headers["X-API-Key"]).toBe("test-key");
+        expect(options.headers["Content-Type"]).toBe("application/json");
+    });
+    it("GET appends query params", async () => {
+        const fakeFetch = mockFetchResponse({ items: [] });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com");
+        await client.get("/api/v1/items", { limit: "10", offset: "0" });
+        const [url] = fakeFetch.mock.calls[0];
+        expect(url).toContain("?");
+        expect(url).toContain("limit=10");
+        expect(url).toContain("offset=0");
+    });
+    it("POST sends JSON body and correct headers", async () => {
+        const fakeFetch = mockFetchResponse({ id: "123" });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("my-key", "https://example.com");
+        const payload = { name: "test", value: 42 };
+        await client.post("/api/v1/create", payload);
+        expect(fakeFetch).toHaveBeenCalledTimes(1);
+        const [url, options] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://example.com/api/v1/create");
+        expect(options.method).toBe("POST");
+        expect(options.headers["X-API-Key"]).toBe("my-key");
+        expect(options.headers["Content-Type"]).toBe("application/json");
+        expect(options.body).toBe(JSON.stringify(payload));
+    });
+    it("POST without body sends undefined body", async () => {
+        const fakeFetch = mockFetchResponse({ done: true });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com");
+        await client.post("/api/v1/action");
+        const [, options] = fakeFetch.mock.calls[0];
+        expect(options.body).toBeUndefined();
+    });
+    it("throws HorizonApiError on non-ok response (GET)", async () => {
+        const fakeFetch = mockFetchResponse("Not Found", {
+            status: 404,
+            ok: false,
+        });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com");
+        await expect(client.get("/api/v1/missing")).rejects.toThrow(HorizonApiError);
+        await expect(client.get("/api/v1/missing")).rejects.toMatchObject({
+            status: 404,
+            body: "Not Found",
+        });
+    });
+    it("throws HorizonApiError on non-ok response (POST)", async () => {
+        const fakeFetch = mockFetchResponse("Bad Request", {
+            status: 400,
+            ok: false,
+        });
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com");
+        await expect(client.post("/api/v1/create", { bad: true })).rejects.toThrow(HorizonApiError);
+        await expect(client.post("/api/v1/create", { bad: true })).rejects.toMatchObject({
+            status: 400,
+            body: "Bad Request",
+        });
+    });
+    it("handles network errors", async () => {
+        const fakeFetch = vi
+            .fn()
+            .mockRejectedValue(new TypeError("fetch failed"));
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com");
+        await expect(client.get("/api/v1/test")).rejects.toThrow("fetch failed");
+        await expect(client.post("/api/v1/test")).rejects.toThrow("fetch failed");
+    });
+    it("strips trailing slash from base URL", async () => {
+        const fakeFetch = mockFetchResponse({});
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = new HorizonApiClient("key", "https://example.com/");
+        await client.get("/api/v1/test");
+        const [url] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://example.com/api/v1/test");
+    });
+});
+// ---------------------------------------------------------------------------
+// createApiClientFromEnv
+// ---------------------------------------------------------------------------
+describe("createApiClientFromEnv", () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        delete process.env.HORIZON_API_KEY;
+        delete process.env.HORIZON_BASE_URL;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    it("returns null when HORIZON_API_KEY is not set", () => {
+        expect(createApiClientFromEnv()).toBeNull();
+    });
+    it("returns a client when HORIZON_API_KEY is set", () => {
+        process.env.HORIZON_API_KEY = "some-key";
+        const client = createApiClientFromEnv();
+        expect(client).toBeInstanceOf(HorizonApiClient);
+    });
+    it("uses HORIZON_BASE_URL when provided", async () => {
+        process.env.HORIZON_API_KEY = "some-key";
+        process.env.HORIZON_BASE_URL = "https://custom.example.com";
+        const fakeFetch = mockFetchResponse({});
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = createApiClientFromEnv();
+        await client.get("/test");
+        const [url] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://custom.example.com/test");
+        globalThis.fetch = globalThis.fetch; // restored in afterEach via vi.stubGlobal
+    });
+    it("defaults to https://horizon.pm when HORIZON_BASE_URL is not set", async () => {
+        process.env.HORIZON_API_KEY = "some-key";
+        const fakeFetch = mockFetchResponse({});
+        vi.stubGlobal("fetch", fakeFetch);
+        const client = createApiClientFromEnv();
+        await client.get("/test");
+        const [url] = fakeFetch.mock.calls[0];
+        expect(url).toBe("https://horizon.pm/test");
+    });
+});
+//# sourceMappingURL=api-client.test.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * HTTP API client for the horizOn App API.
+ *
+ * All requests include the X-API-Key header and Content-Type: application/json.
+ * Non-ok responses throw HorizonApiError with the HTTP status and body.
+ */
+export declare class HorizonApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+export declare class HorizonApiClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey: string, baseUrl: string);
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+}
+/**
+ * Creates an API client from environment variables.
+ * Returns null if HORIZON_API_KEY is not set.
+ * Uses HORIZON_BASE_URL or defaults to "https://horizon.pm".
+ */
+export declare function createApiClientFromEnv(): HorizonApiClient | null;
+//# sourceMappingURL=api-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/tools/api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IASrC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBjE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAiBxD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,GAAG,IAAI,CAOhE"}

package/dist/tools/api-client.js

@@ -0,0 +1,78 @@
+/**
+ * HTTP API client for the horizOn App API.
+ *
+ * All requests include the X-API-Key header and Content-Type: application/json.
+ * Non-ok responses throw HorizonApiError with the HTTP status and body.
+ */
+export class HorizonApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`horizOn API error (${status}): ${body}`);
+        this.status = status;
+        this.body = body;
+        this.name = "HorizonApiError";
+    }
+}
+export class HorizonApiClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl) {
+        if (!apiKey) {
+            throw new Error("API key must not be empty");
+        }
+        this.apiKey = apiKey;
+        // Strip trailing slash so path concatenation is predictable
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+    }
+    async get(path, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params) {
+            const qs = new URLSearchParams(params).toString();
+            if (qs) {
+                url += `?${qs}`;
+            }
+        }
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                "X-API-Key": this.apiKey,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new HorizonApiError(response.status, body);
+        }
+        return (await response.json());
+    }
+    async post(path, body) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                "X-API-Key": this.apiKey,
+                "Content-Type": "application/json",
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const responseBody = await response.text();
+            throw new HorizonApiError(response.status, responseBody);
+        }
+        return (await response.json());
+    }
+}
+/**
+ * Creates an API client from environment variables.
+ * Returns null if HORIZON_API_KEY is not set.
+ * Uses HORIZON_BASE_URL or defaults to "https://horizon.pm".
+ */
+export function createApiClientFromEnv() {
+    const apiKey = process.env.HORIZON_API_KEY;
+    if (!apiKey) {
+        return null;
+    }
+    const baseUrl = process.env.HORIZON_BASE_URL || "https://horizon.pm";
+    return new HorizonApiClient(apiKey, baseUrl);
+}
+//# sourceMappingURL=api-client.js.map

package/dist/tools/api-client.js.map

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

package/dist/tools/auth.d.ts

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

package/dist/tools/auth.d.ts.map

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

package/dist/tools/auth.js

@@ -0,0 +1,123 @@
+import { z } from "zod/v4";
+import { createApiClientFromEnv } from "./api-client.js";
+import { noApiKeyResponse, errorResponse, jsonResponse } from "./tool-helpers.js";
+export function registerAuthTools(server) {
+    // --- Sign up anonymously ---
+    server.registerTool("horizon_signup_anonymous", {
+        title: "Sign Up Anonymously",
+        description: "Creates a new anonymous user account on horizOn with a display name.",
+        inputSchema: {
+            displayName: z.string().max(30).describe("Display name for the anonymous user (max 30 characters)"),
+        },
+    }, async ({ displayName }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/user-management/signup", {
+                type: "ANONYMOUS",
+                username: displayName,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Sign up with email ---
+    server.registerTool("horizon_signup_email", {
+        title: "Sign Up with Email",
+        description: "Creates a new user account on horizOn with email and password.",
+        inputSchema: {
+            email: z.string().email().max(40).describe("Email address (max 40 characters)"),
+            password: z.string().min(4).max(32).describe("Password (4-32 characters)"),
+            displayName: z.string().max(30).describe("Display name (max 30 characters)"),
+        },
+    }, async ({ email, password, displayName }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/user-management/signup", {
+                type: "EMAIL",
+                email,
+                password,
+                username: displayName,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Sign in with email ---
+    server.registerTool("horizon_signin_email", {
+        title: "Sign In with Email",
+        description: "Signs in an existing user on horizOn using email and password.",
+        inputSchema: {
+            email: z.string().email().describe("Email address"),
+            password: z.string().describe("Password"),
+        },
+    }, async ({ email, password }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/user-management/signin", {
+                type: "EMAIL",
+                email,
+                password,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Sign in anonymously ---
+    server.registerTool("horizon_signin_anonymous", {
+        title: "Sign In Anonymously",
+        description: "Signs in an anonymous user on horizOn using their anonymous token.",
+        inputSchema: {
+            anonymousToken: z.string().max(32).describe("Anonymous token (max 32 characters)"),
+        },
+    }, async ({ anonymousToken }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/user-management/signin", {
+                type: "ANONYMOUS",
+                anonymousToken,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Check auth ---
+    server.registerTool("horizon_check_auth", {
+        title: "Check Authentication",
+        description: "Checks whether a user session is still valid on horizOn.",
+        inputSchema: {
+            userId: z.string().uuid().describe("User ID (UUID)"),
+            sessionToken: z.string().max(256).describe("Session token (max 256 characters)"),
+        },
+    }, async ({ userId, sessionToken }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/user-management/check-auth", {
+                userId,
+                sessionToken,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/tools/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CAAC,0BAA0B,EAAE;QAC9C,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yDAAyD,CAAC;SACpG;KACF,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBACrE,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE;QAC1C,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,gEAAgE;QAClE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SAC7E;KACF,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBACrE,IAAI,EAAE,OAAO;gBACb,KAAK;gBACL,QAAQ;gBACR,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE;QAC1C,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,gEAAgE;QAClE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;SAC1C;KACF,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBACrE,IAAI,EAAE,OAAO;gBACb,KAAK;gBACL,QAAQ;aACT,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CAAC,0BAA0B,EAAE;QAC9C,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,oEAAoE;QACtE,WAAW,EAAE;YACX,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SACnF;KACF,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;gBACrE,IAAI,EAAE,WAAW;gBACjB,cAAc;aACf,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,qBAAqB;IACrB,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;QACxC,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,0DAA0D;QAC5D,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SACjF;KACF,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;gBACzE,MAAM;gBACN,YAAY;aACb,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-save.d.ts","sourceRoot":"","sources":["../../src/tools/cloud-save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8C9D"}

package/dist/tools/cloud-save.js

@@ -0,0 +1,50 @@
+import { z } from "zod/v4";
+import { createApiClientFromEnv } from "./api-client.js";
+import { noApiKeyResponse, errorResponse, jsonResponse } from "./tool-helpers.js";
+export function registerCloudSaveTools(server) {
+    // --- Save cloud data ---
+    server.registerTool("horizon_save_cloud_data", {
+        title: "Save Cloud Data",
+        description: "Saves cloud data for a user on horizOn. Data is a string (max 300,000 characters).",
+        inputSchema: {
+            userId: z.string().uuid().describe("User ID (UUID)"),
+            data: z.string().max(300000).describe("Save data string (max 300,000 characters)"),
+        },
+    }, async ({ userId, data }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/cloud-save/save", {
+                userId,
+                saveData: data,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Load cloud data ---
+    server.registerTool("horizon_load_cloud_data", {
+        title: "Load Cloud Data",
+        description: "Loads cloud save data for a user from horizOn.",
+        inputSchema: {
+            userId: z.string().uuid().describe("User ID (UUID)"),
+        },
+    }, async ({ userId }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/cloud-save/load", {
+                userId,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=cloud-save.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-save.js","sourceRoot":"","sources":["../../src/tools/cloud-save.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,0BAA0B;IAC1B,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE;QAC7C,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,oFAAoF;QACtF,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACnF;KACF,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBAC9D,MAAM;gBACN,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE;QAC7C,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,gDAAgD;QAClD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACrD;KACF,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBAC9D,MAAM;aACP,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/connection.d.ts

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

package/dist/tools/connection.d.ts.map

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

package/dist/tools/connection.js

@@ -0,0 +1,20 @@
+import { createApiClientFromEnv } from "./api-client.js";
+import { noApiKeyResponse, errorResponse, jsonResponse } from "./tool-helpers.js";
+export function registerConnectionTools(server) {
+    server.registerTool("horizon_test_connection", {
+        title: "Test Connection",
+        description: "Tests the connection to the horizOn API by fetching all remote configs as a health check. Returns success or failure.",
+    }, async () => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.get("/api/v1/app/remote-config/all");
+            return jsonResponse({ success: true, data: result });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=connection.js.map

package/dist/tools/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/tools/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE;QAC7C,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,uHAAuH;KAC1H,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/feedback.d.ts

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

package/dist/tools/feedback.d.ts.map

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

package/dist/tools/feedback.js

@@ -0,0 +1,36 @@
+import { z } from "zod/v4";
+import { createApiClientFromEnv } from "./api-client.js";
+import { noApiKeyResponse, errorResponse, jsonResponse } from "./tool-helpers.js";
+export function registerFeedbackTools(server) {
+    server.registerTool("horizon_submit_feedback", {
+        title: "Submit Feedback",
+        description: "Submits user feedback to horizOn with a title, message, and optional category, email, and device info.",
+        inputSchema: {
+            userId: z.string().uuid().describe("User ID (UUID)"),
+            title: z.string().min(1).max(100).describe("Feedback title (1-100 characters)"),
+            message: z.string().min(1).max(2048).describe("Feedback message (1-2048 characters)"),
+            category: z.string().max(50).optional().describe("Feedback category (max 50 characters)"),
+            email: z.string().email().optional().describe("Contact email address"),
+            deviceInfo: z.string().max(500).optional().describe("Device information (max 500 characters)"),
+        },
+    }, async ({ userId, title, message, category, email, deviceInfo }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const body = { userId, title, message };
+            if (category !== undefined)
+                body.category = category;
+            if (email !== undefined)
+                body.email = email;
+            if (deviceInfo !== undefined)
+                body.deviceInfo = deviceInfo;
+            const result = await client.post("/api/v1/app/user-feedback/submit", body);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=feedback.js.map

package/dist/tools/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/tools/feedback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE;QAC7C,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,wGAAwG;QAC1G,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACzF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SAC/F;KACF,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QACnE,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YACjE,IAAI,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5C,IAAI,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAE3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;YAC3E,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/gift-codes.d.ts

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

package/dist/tools/gift-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gift-codes.d.ts","sourceRoot":"","sources":["../../src/tools/gift-codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgD7D"}

package/dist/tools/gift-codes.js

@@ -0,0 +1,52 @@
+import { z } from "zod/v4";
+import { createApiClientFromEnv } from "./api-client.js";
+import { noApiKeyResponse, errorResponse, jsonResponse } from "./tool-helpers.js";
+export function registerGiftCodeTools(server) {
+    // --- Validate gift code ---
+    server.registerTool("horizon_validate_gift_code", {
+        title: "Validate Gift Code",
+        description: "Validates a gift code on horizOn without redeeming it. Checks if the code is valid for the given user.",
+        inputSchema: {
+            code: z.string().max(50).describe("Gift code to validate (max 50 characters)"),
+            userId: z.string().uuid().describe("User ID (UUID)"),
+        },
+    }, async ({ code, userId }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/gift-codes/validate", {
+                code,
+                userId,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // --- Redeem gift code ---
+    server.registerTool("horizon_redeem_gift_code", {
+        title: "Redeem Gift Code",
+        description: "Redeems a gift code on horizOn for the given user.",
+        inputSchema: {
+            code: z.string().max(50).describe("Gift code to redeem (max 50 characters)"),
+            userId: z.string().uuid().describe("User ID (UUID)"),
+        },
+    }, async ({ code, userId }) => {
+        const client = createApiClientFromEnv();
+        if (!client)
+            return noApiKeyResponse();
+        try {
+            const result = await client.post("/api/v1/app/gift-codes/redeem", {
+                code,
+                userId,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=gift-codes.js.map