codewars-mcp 1.0.1 → 1.0.3

package/README.md

@@ -23,21 +23,4 @@ The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code
 
 This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required.
 
-<!-- paywall -->
-## Premium tools
 
-These tools need a licence key:
-
-* `language_progress`
-* `completion_timeline`
-
-The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:
-
-```json
-"env": { "MCP_LICENSE_KEY": "polar_..." }
-```
-
-The gateway checks the key against Polar and gives every key 1,000 free premium
-calls a month before per-call billing starts. Every other tool on this server
-stays free.
-<!-- /paywall -->

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { CodewarsError, formatKata, formatUser, getKata, getUser, completedKata, supportedLanguages } from "./api.js";
-import { premiumTool } from "./gateway.js";
 const text = (t) => ({ content: [{ type: "text", text: t }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -22,7 +21,7 @@ export function createServer() {
             return text(formatUser(await getUser(username)));
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
     server.registerTool("get_kata", {
@@ -37,7 +36,7 @@ export function createServer() {
             return text(formatKata(await getKata(id_or_slug)));
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
     server.registerTool("completed_kata", {
@@ -54,7 +53,7 @@ export function createServer() {
             return text(await completedKata(args));
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
     server.registerTool("language_progress", {
@@ -66,14 +65,12 @@ export function createServer() {
         }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // ---- paywall: language_progress ----
-        // The body runs on the gateway, behind the licence gate.
-        // ---- paywall: end ----
+        // TODO: implement progress locally (paywall removed)
         try {
-            return text(await premiumTool("mcp_codewars_language_progress", args));
+            return textError("Not yet implemented: progress");
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
     server.registerTool("completion_timeline", {
@@ -84,14 +81,12 @@ export function createServer() {
         }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // ---- paywall: completion_timeline ----
-        // The body runs on the gateway, behind the licence gate.
-        // ---- paywall: end ----
+        // TODO: implement timeline locally (paywall removed)
         try {
-            return text(await premiumTool("mcp_codewars_completion_timeline", args));
+            return textError("Not yet implemented: timeline");
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
     server.registerTool("supported_languages", {
@@ -107,9 +102,42 @@ export function createServer() {
             return text(await supportedLanguages(args));
         }
         catch (e) {
-            return textError(errorMessage(e));
+            return textError(String(e));
         }
     });
+    const serverName = "codewars-mcp";
+    server.registerTool("health_check", {
+        title: "Health check",
+        description: "Check if the server is running and responsive.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("OK - server is running");
+    });
+    server.registerTool("version_info", {
+        title: "Version info",
+        description: "Get server version and metadata.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text(JSON.stringify({ name: serverName, version: "1.0.0" }, null, 2));
+    });
+    server.registerTool("list_tools", {
+        title: "List tools",
+        description: "List all available tools on this server.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("See the tools/list response for the full tool list.");
+    });
+    server.registerTool("echo", {
+        title: "Echo",
+        description: "Echo back the provided text.",
+        inputSchema: z.object({ text: z.string().describe("Text to echo.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        return text(String(args?.text ?? ""));
+    });
     return server;
 }
 function errorMessage(e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codewars-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Keyless MCP server for Codewars: user ranks, honor, kata.",
   "type": "module",
   "mcpName": "io.github.mrfentmen/codewars-mcp",

package/dist/gateway.d.ts

@@ -1,16 +0,0 @@
-/**
- * Thin client for the premium gateway.
- *
- * The premium tools do not run in this package any more. Their bodies live on
- * the gateway, which checks a Polar licence key before it does any work, so
- * deleting anything here buys nothing: the answer only exists behind the gate.
- *
- * Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
- * endpoint, which is only useful for testing.
- */
-/** Raised when a premium call cannot be completed. `message` is safe to show. */
-export declare class GatewayError extends Error {
-    readonly refused: boolean;
-    constructor(message: string, refused: boolean);
-}
-export declare function premiumTool(tool: string, args: Record<string, unknown>): Promise<string>;

package/dist/gateway.js

@@ -1,85 +0,0 @@
-/**
- * Thin client for the premium gateway.
- *
- * The premium tools do not run in this package any more. Their bodies live on
- * the gateway, which checks a Polar licence key before it does any work, so
- * deleting anything here buys nothing: the answer only exists behind the gate.
- *
- * Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
- * endpoint, which is only useful for testing.
- */
-const DEFAULT_GATEWAY_URL = 'https://mcp-gateway.contactae2000.workers.dev/mcp';
-const DEFAULT_TIMEOUT_MS = 25000;
-const USER_AGENT = 'mrfentmen-mcp/1.0';
-/** Raised when a premium call cannot be completed. `message` is safe to show. */
-export class GatewayError extends Error {
-    refused;
-    constructor(message, refused) {
-        super(message);
-        this.refused = refused;
-        this.name = 'GatewayError';
-    }
-}
-export async function premiumTool(tool, args) {
-    const key = (process.env.MCP_LICENSE_KEY ?? '').trim();
-    if (!key) {
-        throw new GatewayError(`"${tool}" is a premium tool and no licence key is set. Set MCP_LICENSE_KEY in your MCP client config.`, true);
-    }
-    const url = (process.env.MCP_GATEWAY_URL ?? DEFAULT_GATEWAY_URL).trim();
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
-    let response;
-    try {
-        response = await fetch(url, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-                accept: 'application/json',
-                'user-agent': USER_AGENT,
-                authorization: `Bearer ${key}`,
-            },
-            body: JSON.stringify({
-                jsonrpc: '2.0',
-                id: 1,
-                method: 'tools/call',
-                params: { name: tool, arguments: args },
-            }),
-            signal: controller.signal,
-        });
-    }
-    catch {
-        throw new GatewayError(`"${tool}" could not reach the licence gateway. Check your connection and try again.`, false);
-    }
-    finally {
-        clearTimeout(timer);
-    }
-    if (!response.ok) {
-        throw new GatewayError(`"${tool}" could not reach the licence gateway (HTTP ${response.status}).`, false);
-    }
-    let body;
-    try {
-        body = (await response.json());
-    }
-    catch {
-        throw new GatewayError(`"${tool}" got an unreadable answer from the licence gateway.`, false);
-    }
-    if (body.error) {
-        throw new GatewayError(`"${tool}" was refused by the licence gateway: ${body.error.message ?? 'unknown error'}`, false);
-    }
-    const result = body.result ?? {};
-    const text = (result.content ?? [])
-        .map((part) => part.text ?? '')
-        .join('\n')
-        .trim();
-    if (result.isError) {
-        // The gateway marks a licence refusal structurally, so a missing or rejected
-        // key is told apart from a tool that failed after the gate let it through.
-        if (result.structuredContent?.licenceRefusal) {
-            throw new GatewayError(text || `"${tool}" needs a valid licence key.`, true);
-        }
-        throw new GatewayError(text || `"${tool}" failed on the licence gateway.`, false);
-    }
-    if (!text)
-        throw new GatewayError(`"${tool}" returned no data.`, false);
-    return text;
-}