@markmnl/fmsg-mcp 0.1.0 → 0.1.1

package/README.md

@@ -120,6 +120,8 @@ attach resources; prompts `chat` and `reply` script the wait → reply loop and
 
 The API key is exchanged for a short-lived access token that the server renews automatically.
 
+Over stdio the server also starts with no credentials at all, so hosts and directories can list its tools; every tool call then returns a message naming the missing variables.
+
 ## Safety
 
 - Sent messages cannot be edited or recalled; send tools say so in their descriptions and are

package/dist/config.d.ts

@@ -28,4 +28,12 @@ export type ConfigOverrides = {
     host?: string;
     port?: number;
 };
-export declare function loadConfig(env: NodeJS.ProcessEnv, transport: Transport, overrides?: ConfigOverrides): Config;
+export type LoadConfigOptions = {
+    /**
+     * stdio only: when false, a missing FMSG_API_URL / FMSG_API_KEY does not throw and
+     * `apiUrl` is left empty, so the server can still start and answer introspection
+     * (tools/list etc.). Tools then fail with a configuration hint when called.
+     */
+    requireCredentials?: boolean;
+};
+export declare function loadConfig(env: NodeJS.ProcessEnv, transport: Transport, overrides?: ConfigOverrides, options?: LoadConfigOptions): Config;

package/dist/config.js

@@ -37,14 +37,16 @@ function loadDirectory(path) {
     }
     return out;
 }
-export function loadConfig(env, transport, overrides = {}) {
-    const apiUrl = env.FMSG_API_URL?.trim();
-    if (!apiUrl)
+export function loadConfig(env, transport, overrides = {}, options = {}) {
+    const requireCredentials = options.requireCredentials ?? true;
+    const apiUrl = env.FMSG_API_URL?.trim() ?? "";
+    if (!apiUrl && (transport === "http" || requireCredentials)) {
         throw new Error("FMSG_API_URL is required (base URL of the fmsg Web API, e.g. https://api.example.com)");
-    if (!/^https?:\/\//u.test(apiUrl))
+    }
+    if (apiUrl && !/^https?:\/\//u.test(apiUrl))
         throw new Error("FMSG_API_URL must start with http:// or https://");
     const apiKey = env.FMSG_API_KEY?.trim();
-    if (transport === "stdio" && !apiKey) {
+    if (transport === "stdio" && !apiKey && requireCredentials) {
         throw new Error("FMSG_API_KEY is required in stdio mode (an fmsgk_... key for the address this server sends as)");
     }
     if (transport === "http" && apiKey) {

package/dist/context.d.ts

@@ -17,4 +17,10 @@ export declare class StaticCallerProvider implements CallerProvider {
     constructor(client: FmsgClient);
     forRequest(): Promise<Caller>;
 }
+/** stdio without credentials: the server starts (so hosts can list tools) but every tool explains what is missing. */
+export declare class UnconfiguredCallerProvider implements CallerProvider {
+    private readonly reason;
+    constructor(reason: string);
+    forRequest(): Promise<Caller>;
+}
 export declare function callerFor(provider: CallerProvider, ctx: ServerContext): Promise<Caller>;

package/dist/context.js

@@ -12,6 +12,16 @@ export class StaticCallerProvider {
         return this.caller;
     }
 }
+/** stdio without credentials: the server starts (so hosts can list tools) but every tool explains what is missing. */
+export class UnconfiguredCallerProvider {
+    reason;
+    constructor(reason) {
+        this.reason = reason;
+    }
+    forRequest() {
+        return Promise.reject(new Error(this.reason));
+    }
+}
 export async function callerFor(provider, ctx) {
     return provider.forRequest(ctx.http?.authInfo);
 }

package/dist/index.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { FmsgClient } from "./client/client.js";
 import { loadConfig, DEFAULT_HTTP_PORT } from "./config.js";
-import { StaticCallerProvider } from "./context.js";
+import { StaticCallerProvider, UnconfiguredCallerProvider } from "./context.js";
 import { createHttpServer, MCP_PATH } from "./http.js";
 import { createFmsgMcpServer } from "./server.js";
 import { PACKAGE_NAME, VERSION } from "./version.js";
@@ -89,18 +89,26 @@ async function main() {
     const transport = args.mode;
     let config;
     try {
-        config = loadConfig(process.env, transport, args.overrides);
+        config = loadConfig(process.env, transport, args.overrides, { requireCredentials: false });
     }
     catch (error) {
         console.error(`fmsg-mcp: ${error instanceof Error ? error.message : String(error)}`);
         process.exit(2);
     }
     if (transport === "stdio") {
-        const client = new FmsgClient(config.apiUrl, config.apiKey);
-        const provider = new StaticCallerProvider(client);
         const cfg = config;
+        let provider;
+        if (cfg.apiUrl && cfg.apiKey) {
+            provider = new StaticCallerProvider(new FmsgClient(cfg.apiUrl, cfg.apiKey));
+            console.error(`fmsg-mcp ${VERSION} serving stdio for ${cfg.apiUrl}`);
+        }
+        else {
+            const missing = [!cfg.apiUrl && "FMSG_API_URL", !cfg.apiKey && "FMSG_API_KEY"].filter(Boolean).join(" and ");
+            const reason = `fmsg-mcp is not configured: set ${missing} (the fmsg Web API base URL and an fmsgk_... API key for the address this server sends as)`;
+            provider = new UnconfiguredCallerProvider(reason);
+            console.error(`fmsg-mcp ${VERSION} serving stdio WITHOUT credentials (${missing} not set): tools are listed but every call will fail until configured`);
+        }
         const handle = serveStdio(() => createFmsgMcpServer(provider, cfg));
-        console.error(`fmsg-mcp ${VERSION} serving stdio for ${config.apiUrl}`);
         const stop = () => void handle.close().finally(() => process.exit(0));
         process.on("SIGINT", stop);
         process.on("SIGTERM", stop);

package/dist/public.d.ts

@@ -1,7 +1,7 @@
 export { createFmsgMcpServer, SERVER_NAME } from "./server.js";
 export { createHttpServer, type HttpServerHandle } from "./http.js";
-export { loadConfig, type Config, type Transport } from "./config.js";
-export { StaticCallerProvider, type Caller, type CallerProvider } from "./context.js";
+export { loadConfig, type Config, type LoadConfigOptions, type Transport } from "./config.js";
+export { StaticCallerProvider, UnconfiguredCallerProvider, type Caller, type CallerProvider } from "./context.js";
 export { ApiKeyCallerProvider } from "./auth.js";
 export { waitForMessage, type WaitOptions, type WaitResult } from "./wait.js";
 export { assembleThread, renderThread, type AssembledThread } from "./thread.js";

package/dist/public.js

@@ -1,7 +1,7 @@
 export { createFmsgMcpServer, SERVER_NAME } from "./server.js";
 export { createHttpServer } from "./http.js";
 export { loadConfig } from "./config.js";
-export { StaticCallerProvider } from "./context.js";
+export { StaticCallerProvider, UnconfiguredCallerProvider } from "./context.js";
 export { ApiKeyCallerProvider } from "./auth.js";
 export { waitForMessage } from "./wait.js";
 export { assembleThread, renderThread } from "./thread.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@markmnl/fmsg-mcp",
   "mcpName": "io.github.markmnl/fmsg-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for fmsg: send and receive federated messages from any AI agent via a deployed fmsg Web API",
   "type": "module",
   "license": "MIT",

package/server.json

@@ -6,18 +6,33 @@
     "url": "https://github.com/markmnl/fmsg-mcp",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.1.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@markmnl/fmsg-mcp",
-      "version": "0.1.0",
-      "transport": { "type": "stdio" },
+      "version": "0.1.1",
+      "transport": {
+        "type": "stdio"
+      },
       "environmentVariables": [
-        { "name": "FMSG_API_URL", "description": "Base URL of the fmsg Web API", "isRequired": true },
-        { "name": "FMSG_API_KEY", "description": "fmsg API key (fmsgk_...) for the address to send as", "isRequired": true, "isSecret": true },
-        { "name": "FMSG_DEFAULT_DOMAIN", "description": "Optional: lets short names resolve to @name@<domain>", "isRequired": false }
+        {
+          "name": "FMSG_API_URL",
+          "description": "Base URL of the fmsg Web API",
+          "isRequired": true
+        },
+        {
+          "name": "FMSG_API_KEY",
+          "description": "fmsg API key (fmsgk_...) for the address to send as",
+          "isRequired": true,
+          "isSecret": true
+        },
+        {
+          "name": "FMSG_DEFAULT_DOMAIN",
+          "description": "Optional: lets short names resolve to @name@<domain>",
+          "isRequired": false
+        }
       ]
     }
   ]