askell-mcp 0.4.0 → 0.4.2

package/README.md

@@ -28,7 +28,7 @@ Prefer **two server entries** if you have both production and sandbox keys. Tool
   "mcpServers": {
     "askell-prod": {
       "command": "bunx",
-      "args": ["-y", "askell-mcp"],
+      "args": ["-y", "askell-mcp@latest"],
       "env": {
         "ASKELL_ENV": "production",
         "ASKELL_PRIVATE_API_KEY": "your_production_secret_api_key"
@@ -36,7 +36,7 @@ Prefer **two server entries** if you have both production and sandbox keys. Tool
     },
     "askell-sandbox": {
       "command": "bunx",
-      "args": ["-y", "askell-mcp"],
+      "args": ["-y", "askell-mcp@latest"],
       "env": {
         "ASKELL_ENV": "sandbox",
         "ASKELL_PRIVATE_API_KEY": "your_sandbox_secret_api_key"
@@ -73,7 +73,7 @@ Restart the client after saving.
 | `ASKELL_PRIVATE_API_KEY`           | yes\*    | —                       | Secret API key (_or_ `ASKELL_SECRET_API_KEY`)   |
 | `ASKELL_PUBLIC_API_KEY`            | no       | —                       | Public key for a few checkout/payment endpoints |
 | `ASKELL_ENV`                       | no       | `production`            | `production` \| `sandbox` — selects the official API host |
-| `ASKELL_API_URL`                   | no       | —                       | Custom/local API base only (_or_ `ASKELL_API_BASE_URL`). Do not set together with `ASKELL_ENV` unless it matches |
+| `ASKELL_API_BASE_URL`              | no       | —                       | Custom/local API base only. Do not set together with `ASKELL_ENV` unless it matches |
 | `ASKELL_RESPONSE_MAX_BYTES`        | no       | `64000`                 | Max response size returned to the model         |
 | `ASKELL_MUTATION_GATE`             | no       | `auto`                  | `auto` / `elicit` / `off` — see below           |
 | `ASKELL_REQUIRE_MUTATION_APPROVAL` | no       | —                       | Deprecated alias: `true`→`elicit`, `false`→`off` |

package/mcp.json.example

@@ -2,7 +2,7 @@
   "mcpServers": {
     "askell-prod": {
       "command": "bunx",
-      "args": ["-y", "askell-mcp"],
+      "args": ["-y", "askell-mcp@latest"],
       "env": {
         "ASKELL_ENV": "production",
         "ASKELL_PRIVATE_API_KEY": "your_production_secret_api_key",
@@ -11,7 +11,7 @@
     },
     "askell-sandbox": {
       "command": "bunx",
-      "args": ["-y", "askell-mcp"],
+      "args": ["-y", "askell-mcp@latest"],
       "env": {
         "ASKELL_ENV": "sandbox",
         "ASKELL_PRIVATE_API_KEY": "your_sandbox_secret_api_key",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "askell-mcp",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "MCP server for the Askell payment and subscription API (Bun + stdio)",
   "author": "Neschadin Oleksandr",
   "license": "MIT",
@@ -43,6 +43,8 @@
   },
   "scripts": {
     "dev": "bun run src/index.ts",
+    "dev:prod": "bun --no-env-file --env-file=.env run src/index.ts",
+    "dev:sandbox": "bun --no-env-file --env-file=.env.sandbox run src/index.ts",
     "start": "bun run bin/askell-mcp",
     "test": "bun test",
     "smoke": "bun run scripts/smoke-test.ts",

package/src/config.ts

@@ -67,12 +67,12 @@ export function resolveAskellTarget(input: {
     if (input.askellEnv !== undefined) {
       if (classified === 'custom') {
         throw new Error(
-          `ASKELL_ENV=${input.askellEnv} selects an official Askell host; omit ASKELL_ENV when ASKELL_API_URL is custom (${apiBaseUrl})`,
+          `ASKELL_ENV=${input.askellEnv} selects an official Askell host; omit ASKELL_ENV when ASKELL_API_BASE_URL is custom (${apiBaseUrl})`,
         );
       }
       if (classified !== input.askellEnv) {
         throw new Error(
-          `ASKELL_ENV=${input.askellEnv} does not match ASKELL_API_URL (${apiBaseUrl}). Omit ASKELL_API_URL and let ASKELL_ENV pick the host, or omit ASKELL_ENV.`,
+          `ASKELL_ENV=${input.askellEnv} does not match ASKELL_API_BASE_URL (${apiBaseUrl}). Omit ASKELL_API_BASE_URL and let ASKELL_ENV pick the host, or omit ASKELL_ENV.`,
         );
       }
     }
@@ -132,7 +132,7 @@ const CONFIG_HELP = `Askell MCP credentials missing.
 
 Set ASKELL_PRIVATE_API_KEY (or ASKELL_SECRET_API_KEY), optionally ASKELL_PUBLIC_API_KEY.
 Set ASKELL_ENV=production|sandbox (default production) — the server picks the host.
-Keys are per host. ASKELL_API_URL is only for a custom/local API.
+Keys are per host. ASKELL_API_BASE_URL is only for a custom/local API.
 
   Local dev — create .env in the project root (Bun loads it automatically):
     ASKELL_ENV=sandbox
@@ -144,7 +144,7 @@ Keys are per host. ASKELL_API_URL is only for a custom/local API.
       "mcpServers": {
         "askell-prod": {
           "command": "bunx",
-          "args": ["-y", "askell-mcp"],
+          "args": ["-y", "askell-mcp@latest"],
           "env": {
             "ASKELL_ENV": "production",
             "ASKELL_PRIVATE_API_KEY": "...",
@@ -153,7 +153,7 @@ Keys are per host. ASKELL_API_URL is only for a custom/local API.
         },
         "askell-sandbox": {
           "command": "bunx",
-          "args": ["-y", "askell-mcp"],
+          "args": ["-y", "askell-mcp@latest"],
           "env": {
             "ASKELL_ENV": "sandbox",
             "ASKELL_PRIVATE_API_KEY": "...",
@@ -172,7 +172,7 @@ function loadConfigFromEnv(): unknown {
   }
 
   const askellEnv = env.ASKELL_ENV?.trim() || undefined;
-  const apiBaseUrl = env.ASKELL_API_URL ?? env.ASKELL_API_BASE_URL;
+  const apiBaseUrl = env.ASKELL_API_BASE_URL;
   const responseMaxBytes = env.ASKELL_RESPONSE_MAX_BYTES;
   const mutationGateRaw =
     env.ASKELL_MUTATION_GATE ?? env.ASKELL_REQUIRE_MUTATION_APPROVAL;

package/src/index.ts

@@ -8,7 +8,9 @@ try {
 
   void serveStdio(() => createServer(config));
 
-  console.error('askell-mcp running on stdio');
+  console.error(
+    `askell-mcp running on stdio (${config.askellEnv} ${config.apiBaseUrl})`,
+  );
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`askell-mcp failed to start: ${message}`);

package/src/server.ts

@@ -17,7 +17,7 @@ export function buildServerInstructions(config: AppConfig): string {
   const apiBase = normalizeBaseUrl(config.apiBaseUrl);
   const envLine =
     config.askellEnv === 'custom'
-      ? `This instance: custom API base ${apiBase} (ASKELL_API_URL override)`
+      ? `This instance: custom API base ${apiBase} (ASKELL_API_BASE_URL override)`
       : `This instance: ${config.askellEnv} (${apiBase})`;
 
   return `Askell MCP server for payment and subscription operations.