@relaymessenger/mcp 0.1.0-staging.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Relay Messenger, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# Relay MCP
+
+`@relaymessenger/mcp` is a local MCP v2 stdio server for current Relay v1
+Agent tools. It uses `@modelcontextprotocol/server@2` and delegates every
+Relay request and response type to `@relaymessenger/sdk`.
+
+## Transport and security status
+
+**Implemented:** local process-spawned stdio, including MCP v2 modern-era
+negotiation and legacy client compatibility.
+
+**Not implemented:** remote HTTP transport and remote OAuth. The package does
+not open a port, advertise a remote endpoint, or claim remote authentication.
+Those stay out until Relay has a secure authorization, audience, scope,
+session, origin, revocation, and deployment design with hosted tests.
+
+The stdio host is the security boundary. Only configure this server in a
+trusted local MCP client.
+
+## Install and configure
+
+```sh
+npm install --global @relaymessenger/mcp
+relay-mcp --version
+```
+
+The server resolves an Agent Token locally; it never exposes a token as an MCP
+tool argument.
+
+Resolution order:
+
+1. `RELAY_AGENT_TOKEN`, `RELAY_API_URL`, and `RELAY_PROFILE`;
+2. `${XDG_CONFIG_HOME:-~/.config}/relay/config.json`, shared with
+   `@relaymessenger/cli`;
+3. `https://api.relayapp.im` as the default API URL.
+
+Example client configuration:
+
+```json
+{
+  "mcpServers": {
+    "relay": {
+      "command": "relay-mcp",
+      "env": {
+        "RELAY_PROFILE": "default"
+      }
+    }
+  }
+}
+```
+
+For automation, inject `RELAY_AGENT_TOKEN` from the host's secret manager.
+Do not put the token in MCP config checked into source control.
+
+Optional non-secret process flags:
+
+```sh
+relay-mcp --profile staging
+relay-mcp --profile local --api-url http://127.0.0.1:8787
+```
+
+There is deliberately no token flag.
+
+## Tools
+
+The server exposes explicit tools rather than a generic HTTP or operation
+proxy:
+
+| Capability | Tools |
+| --- | --- |
+| Read | `relay_list_chats`, `relay_get_chat`, `relay_list_messages`, `relay_get_message`, `relay_get_message_thread` |
+| Send | `relay_send_message`, `relay_send_message_to_chat` |
+| Reactions | `relay_react_to_message` |
+| Typing/read state | `relay_start_typing`, `relay_stop_typing`, `relay_mark_chat_read` |
+| Contact Card | `relay_get_contact_card`, `relay_set_contact_card`, `relay_update_contact_card`, `relay_share_contact_card` |
+| Contact request | `relay_create_contact_request` |
+
+Message-send tools require a caller-supplied idempotency key. Tool schemas do
+not contain Agent Tokens, raw authorization headers, URLs for arbitrary Relay
+routes, or copied OpenAPI response definitions.
+
+## Errors and secrets
+
+Tool failures return MCP error results with sanitized text. Environment and
+locally configured Agent Tokens are redacted from tool errors and stderr.
+Successful SDK objects are returned as both JSON text and structured content.
+
+## Development
+
+All Linux execution happens in a fresh Daytona sandbox:
+
+```sh
+npm ci
+npm run validate
+```
+
+Validation includes type checking, unit and negative tests, the pinned SDK
+contract hash, an MCP v2 modern protocol spawn test, MCP Inspector v2
+`tools/list --strict`, package packing, isolated tarball installation, and an
+installed-bin protocol test.

package/dist/auth.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_API_URL = "https://api.relayapp.im";
+export declare const DEFAULT_PROFILE = "default";
+export interface AuthContext {
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    profile?: string;
+    apiURL?: string;
+}
+export interface ResolvedAgentAuth {
+    profile: string;
+    apiURL: string;
+    token: string;
+    source: "environment" | "profile";
+    configPath: string;
+}
+export declare const relayConfigPath: (context?: AuthContext) => string;
+export declare const validateApiURL: (input: string) => string;
+export declare const resolveAgentAuth: (context?: AuthContext) => Promise<ResolvedAgentAuth>;
+export declare const collectLocalTokens: (context?: AuthContext) => Promise<string[]>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,4BAA4B,CAAC;AACzD,eAAO,MAAM,eAAe,YAAY,CAAC;AAazC,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,eAAO,MAAM,eAAe,GAAI,UAAS,WAAgB,KAAG,MAY3D,CAAC;AAeF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAuB9C,CAAC;AA8DF,eAAO,MAAM,gBAAgB,GAC3B,UAAS,WAAgB,KACxB,OAAO,CAAC,iBAAiB,CA+B3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAS,WAAgB,KACxB,OAAO,CAAC,MAAM,EAAE,CAalB,CAAC"}

package/dist/auth.js

@@ -0,0 +1,148 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
+export const DEFAULT_API_URL = "https://api.relayapp.im";
+export const DEFAULT_PROFILE = "default";
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const envFor = (context) => context.env ?? process.env;
+export const relayConfigPath = (context = {}) => {
+    const env = envFor(context);
+    if (env.RELAY_CONFIG_PATH) {
+        if (!isAbsolute(env.RELAY_CONFIG_PATH)) {
+            throw new Error("RELAY_CONFIG_PATH must be absolute.");
+        }
+        return env.RELAY_CONFIG_PATH;
+    }
+    const root = env.RELAY_CONFIG_DIR
+        ?? env.XDG_CONFIG_HOME
+        ?? join(context.home ?? homedir(), ".config");
+    return resolve(root, "relay", "config.json");
+};
+const profileName = (value) => {
+    if (!/^[a-z0-9][a-z0-9_-]{0,63}$/i.test(value)) {
+        throw new Error("Relay profile name is invalid.");
+    }
+    return value;
+};
+const isLoopback = (hostname) => hostname === "localhost"
+    || hostname === "127.0.0.1"
+    || hostname === "::1"
+    || hostname === "[::1]";
+export const validateApiURL = (input) => {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch (cause) {
+        throw new Error("Relay API URL must be absolute.", { cause });
+    }
+    if (url.username
+        || url.password
+        || url.search
+        || url.hash
+        || (url.pathname !== "" && url.pathname !== "/")) {
+        throw new Error("Relay API URL must be an origin without credentials.");
+    }
+    if (url.protocol !== "https:"
+        && !(url.protocol === "http:" && isLoopback(url.hostname))) {
+        throw new Error("Relay API URL must use HTTPS (HTTP is loopback-only).");
+    }
+    return url.origin;
+};
+const tokenValue = (input) => {
+    const token = input.trim();
+    if (!token || /[\r\n\0]/.test(token)) {
+        throw new Error("Relay Agent Token is empty or malformed.");
+    }
+    return token;
+};
+const readLocalConfig = async (context) => {
+    try {
+        const parsed = JSON.parse(await readFile(relayConfigPath(context), "utf8"));
+        if (!isRecord(parsed)
+            || parsed.version !== 1
+            || typeof parsed.current_profile !== "string"
+            || !isRecord(parsed.profiles)) {
+            throw new Error("Relay config has an unsupported format.");
+        }
+        const profiles = {};
+        for (const [name, raw] of Object.entries(parsed.profiles)) {
+            profileName(name);
+            if (!isRecord(raw))
+                throw new Error(`Relay profile ${name} is invalid.`);
+            const apiURL = raw.api_url;
+            const token = raw.agent_token;
+            if (apiURL !== undefined && typeof apiURL !== "string") {
+                throw new Error(`Relay profile ${name} has an invalid API URL.`);
+            }
+            if (token !== undefined && typeof token !== "string") {
+                throw new Error(`Relay profile ${name} has an invalid Agent Token.`);
+            }
+            profiles[name] = {
+                ...(apiURL === undefined ? {} : { api_url: validateApiURL(apiURL) }),
+                ...(token === undefined ? {} : { agent_token: tokenValue(token) }),
+            };
+        }
+        return {
+            version: 1,
+            current_profile: profileName(parsed.current_profile),
+            profiles,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error
+            && "code" in error
+            && error.code === "ENOENT") {
+            return undefined;
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error("Relay config is not valid JSON.", { cause: error });
+        }
+        throw error;
+    }
+};
+export const resolveAgentAuth = async (context = {}) => {
+    const env = envFor(context);
+    const config = await readLocalConfig(context);
+    const profile = profileName(context.profile
+        ?? env.RELAY_PROFILE
+        ?? config?.current_profile
+        ?? DEFAULT_PROFILE);
+    const selected = config?.profiles[profile];
+    if (config && !selected)
+        throw new Error(`Relay profile ${profile} does not exist.`);
+    const apiURL = validateApiURL(context.apiURL
+        ?? env.RELAY_API_URL
+        ?? selected?.api_url
+        ?? DEFAULT_API_URL);
+    const environmentToken = env.RELAY_AGENT_TOKEN;
+    const token = environmentToken ?? selected?.agent_token;
+    if (!token) {
+        throw new Error(`No Agent Token for Relay profile ${profile}. Configure @relaymessenger/cli or RELAY_AGENT_TOKEN.`);
+    }
+    return {
+        profile,
+        apiURL,
+        token: tokenValue(token),
+        source: environmentToken === undefined ? "profile" : "environment",
+        configPath: relayConfigPath(context),
+    };
+};
+export const collectLocalTokens = async (context = {}) => {
+    const tokens = [];
+    const environmentToken = envFor(context).RELAY_AGENT_TOKEN;
+    if (environmentToken)
+        tokens.push(environmentToken);
+    try {
+        const config = await readLocalConfig(context);
+        for (const profile of Object.values(config?.profiles ?? {})) {
+            if (profile.agent_token)
+                tokens.push(profile.agent_token);
+        }
+    }
+    catch {
+        // A malformed config must not prevent environment-secret redaction.
+    }
+    return [...new Set(tokens)];
+};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { collectLocalTokens, validateApiURL } from "./auth.js";
+import { safeErrorMessage } from "./redact.js";
+import { createRelayMcpServer } from "./server.js";
+const usage = `Usage: relay-mcp [options]
+
+Local MCP v2 stdio server for Relay.
+
+Options:
+  --profile <name>   Select a local Relay profile
+  --api-url <url>    Override the Relay API origin (never an Agent Token)
+  --version          Print package version
+  --help             Print this help
+
+Agent Tokens resolve from RELAY_AGENT_TOKEN or the local Relay profile file.
+Remote HTTP and OAuth transports are not implemented.
+`;
+const parseArgs = (args) => {
+    const context = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === "--help" || argument === "-h")
+            return "help";
+        if (argument === "--version" || argument === "-V")
+            return "version";
+        if (argument === "--profile") {
+            const value = args[++index];
+            if (!value)
+                throw new Error("--profile requires a value.");
+            context.profile = value;
+            continue;
+        }
+        if (argument === "--api-url") {
+            const value = args[++index];
+            if (!value)
+                throw new Error("--api-url requires a value.");
+            context.apiURL = validateApiURL(value);
+            continue;
+        }
+        throw new Error(`Unknown option: ${argument}`);
+    }
+    return context;
+};
+try {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed === "help") {
+        process.stdout.write(usage);
+    }
+    else if (parsed === "version") {
+        process.stdout.write("0.1.0-staging.0\n");
+    }
+    else {
+        serveStdio(() => createRelayMcpServer({ authContext: parsed }), {
+            legacy: "serve",
+            onerror: async (error) => {
+                const secrets = await collectLocalTokens(parsed);
+                process.stderr.write(`Relay MCP error: ${safeErrorMessage(error, secrets)}\n`);
+            },
+        });
+    }
+}
+catch (error) {
+    const secrets = await collectLocalTokens();
+    process.stderr.write(`Relay MCP error: ${safeErrorMessage(error, secrets)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAc,EAAoC,EAAE;IACrE,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QAC9B,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC9D,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACpE,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC3D,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC3D,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,UAAU,CACR,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EACnD;YACE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACjF,CAAC;SACF,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/redact.d.ts

@@ -0,0 +1,3 @@
+export declare const redact: (value: string, secrets: readonly string[]) => string;
+export declare const safeErrorMessage: (error: unknown, secrets: readonly string[]) => string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,GACjB,OAAO,MAAM,EACb,SAAS,SAAS,MAAM,EAAE,KACzB,MAqBF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,OAAO,EACd,SAAS,SAAS,MAAM,EAAE,KACzB,MAGF,CAAC"}

package/dist/redact.js

@@ -0,0 +1,21 @@
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+export const redact = (value, secrets) => {
+    let output = value;
+    for (const secret of secrets) {
+        if (secret.length < 4)
+            continue;
+        output = output.replace(new RegExp(escapeRegExp(secret), "g"), "[REDACTED]");
+        try {
+            const encoded = encodeURIComponent(secret);
+            if (encoded !== secret) {
+                output = output.replace(new RegExp(escapeRegExp(encoded), "g"), "[REDACTED]");
+            }
+        }
+        catch {
+            // Raw replacement above remains effective.
+        }
+    }
+    return output;
+};
+export const safeErrorMessage = (error, secrets) => redact(error instanceof Error ? error.message : String(error), secrets);
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE,CAC7C,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAa,EACb,OAA0B,EAClB,EAAE;IACV,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAChC,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EACrC,YAAY,CACb,CAAC;QACF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,IAAI,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EACtC,YAAY,CACb,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAc,EACd,OAA0B,EAClB,EAAE,CAAC,MAAM,CACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,OAAO,CACR,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import Relay from "@relaymessenger/sdk";
+import type { AuthContext } from "./auth.js";
+export interface ResolvedRelayClient {
+    client: Relay;
+    secrets?: string[];
+}
+export interface RelayMcpServerOptions {
+    authContext?: AuthContext;
+    resolveClient?: () => Promise<ResolvedRelayClient>;
+    collectSecrets?: () => Promise<string[]>;
+}
+export declare const createRelayMcpServer: (options?: RelayMcpServerOptions) => McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAON,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAgGD,eAAO,MAAM,oBAAoB,GAC/B,UAAS,qBAA0B,KAClC,SAgXF,CAAC"}

package/dist/server.js

@@ -0,0 +1,331 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import Relay, {} from "@relaymessenger/sdk";
+import { z } from "zod";
+import { collectLocalTokens, resolveAgentAuth } from "./auth.js";
+import { safeErrorMessage } from "./redact.js";
+const uuid = z.uuid();
+const cursor = z.string().min(1).max(512).optional();
+const limit = z.number().int().min(1).max(100).optional();
+const relayHandle = z.string()
+    .min(1)
+    .max(128)
+    .regex(/^[^@\s]+$/, "Omit the leading @ and whitespace.");
+const idempotencyKey = z.string().min(1).max(255);
+const messageText = z.string().min(1).max(32_000);
+const readAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const writeAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+const idempotentWriteAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const destructiveAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+const serializableObject = (value) => {
+    const normalized = value === undefined ? { ok: true } : value;
+    const serialized = JSON.stringify(normalized);
+    const parsed = JSON.parse(serialized);
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+        return parsed;
+    }
+    return { result: parsed };
+};
+const success = (value) => {
+    const structuredContent = serializableObject(value);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(structuredContent, null, 2),
+            }],
+        structuredContent,
+    };
+};
+const textMessage = (text, stableKey) => ({
+    parts: [{ type: "text", value: text }],
+    idempotency_key: stableKey,
+});
+const operation = async (options, callback) => {
+    let secrets = [];
+    try {
+        secrets = await options.collectSecrets();
+    }
+    catch {
+        // Continue: a malformed local config must not break a custom resolver.
+    }
+    try {
+        const resolved = await options.resolveClient();
+        secrets.push(...(resolved.secrets ?? []));
+        return success(await callback(resolved.client));
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Relay tool failed: ${safeErrorMessage(error, secrets)}`,
+                }],
+            isError: true,
+        };
+    }
+};
+export const createRelayMcpServer = (options = {}) => {
+    const authContext = options.authContext ?? {};
+    const dependencies = {
+        resolveClient: options.resolveClient ?? (async () => {
+            const auth = await resolveAgentAuth(authContext);
+            return {
+                client: new Relay({
+                    apiKey: auth.token,
+                    baseURL: auth.apiURL,
+                }),
+                secrets: [auth.token],
+            };
+        }),
+        collectSecrets: options.collectSecrets
+            ?? (() => collectLocalTokens(authContext)),
+    };
+    const server = new McpServer({
+        name: "relay",
+        version: "0.1.0-staging.0",
+    }, {
+        capabilities: { tools: {} },
+        instructions: "Use explicit Relay tools. Message sends require stable idempotency keys. "
+            + "Agent authentication is resolved locally and is never a tool argument.",
+    });
+    server.registerTool("relay_list_chats", {
+        title: "List Relay Chats",
+        description: "List Chats visible to the authenticated Relay Agent.",
+        inputSchema: z.object({ cursor, limit }),
+        annotations: readAnnotations,
+    }, async (args) => operation(dependencies, async (client) => {
+        const page = await client.chats.listChats({
+            ...(args.cursor ? { cursor: args.cursor } : {}),
+            ...(args.limit === undefined ? {} : { limit: args.limit }),
+        });
+        return { chats: page.chats, next_cursor: page.nextCursor };
+    }));
+    server.registerTool("relay_get_chat", {
+        title: "Get Relay Chat",
+        description: "Retrieve one Relay Chat by ID.",
+        inputSchema: z.object({ chat_id: uuid }),
+        annotations: readAnnotations,
+    }, async ({ chat_id }) => operation(dependencies, (client) => client.chats.retrieve(chat_id)));
+    server.registerTool("relay_list_messages", {
+        title: "List Relay Messages",
+        description: "List Messages in one Relay Chat.",
+        inputSchema: z.object({ chat_id: uuid, cursor, limit }),
+        annotations: readAnnotations,
+    }, async ({ chat_id, cursor: next, limit: pageSize }) => operation(dependencies, async (client) => {
+        const page = await client.chats.messages.list(chat_id, {
+            ...(next ? { cursor: next } : {}),
+            ...(pageSize === undefined ? {} : { limit: pageSize }),
+        });
+        return { messages: page.messages, next_cursor: page.nextCursor };
+    }));
+    server.registerTool("relay_get_message", {
+        title: "Get Relay Message",
+        description: "Retrieve one Relay Message by ID.",
+        inputSchema: z.object({ message_id: uuid }),
+        annotations: readAnnotations,
+    }, async ({ message_id }) => operation(dependencies, (client) => client.messages.retrieve(message_id)));
+    server.registerTool("relay_get_message_thread", {
+        title: "Get Relay Message Thread",
+        description: "List the thread rooted at one Relay Message.",
+        inputSchema: z.object({
+            message_id: uuid,
+            cursor,
+            limit,
+            order: z.enum(["asc", "desc"]).optional(),
+        }),
+        annotations: readAnnotations,
+    }, async ({ message_id, cursor: next, limit: pageSize, order }) => operation(dependencies, async (client) => {
+        const page = await client.messages.listMessagesThread(message_id, {
+            ...(next ? { cursor: next } : {}),
+            ...(pageSize === undefined ? {} : { limit: pageSize }),
+            ...(order ? { order } : {}),
+        });
+        return { messages: page.messages, next_cursor: page.nextCursor };
+    }));
+    server.registerTool("relay_send_message", {
+        title: "Send Relay Message",
+        description: "Resolve or create a Chat and send a text Message to Relay Handles. "
+            + "Reuse the same idempotency key only for the same logical send.",
+        inputSchema: z.object({
+            recipients: z.array(relayHandle).min(1).max(31),
+            text: messageText,
+            idempotency_key: idempotencyKey,
+        }),
+        annotations: idempotentWriteAnnotations,
+    }, async ({ recipients, text, idempotency_key }) => operation(dependencies, (client) => {
+        const body = {
+            to: recipients,
+            message: textMessage(text, idempotency_key),
+        };
+        return client.messages.create(body);
+    }));
+    server.registerTool("relay_send_message_to_chat", {
+        title: "Send Message to Relay Chat",
+        description: "Send a text Message to a known Relay Chat. Reuse the idempotency key "
+            + "only for the same logical send.",
+        inputSchema: z.object({
+            chat_id: uuid,
+            text: messageText,
+            idempotency_key: idempotencyKey,
+        }),
+        annotations: idempotentWriteAnnotations,
+    }, async ({ chat_id, text, idempotency_key }) => operation(dependencies, (client) => {
+        const body = {
+            message: textMessage(text, idempotency_key),
+        };
+        return client.chats.messages.send(chat_id, body);
+    }));
+    const reactionInput = z.object({
+        message_id: uuid,
+        operation: z.enum(["add", "remove"]),
+        type: z.enum([
+            "love",
+            "like",
+            "dislike",
+            "laugh",
+            "emphasize",
+            "question",
+            "custom",
+        ]),
+        custom_emoji: z.string().min(1).max(32).optional(),
+        part_index: z.number().int().min(0).optional(),
+    }).superRefine((value, context) => {
+        if (value.type === "custom" && !value.custom_emoji) {
+            context.addIssue({
+                code: "custom",
+                message: "custom_emoji is required when type is custom.",
+                path: ["custom_emoji"],
+            });
+        }
+        if (value.type !== "custom" && value.custom_emoji) {
+            context.addIssue({
+                code: "custom",
+                message: "custom_emoji is allowed only when type is custom.",
+                path: ["custom_emoji"],
+            });
+        }
+    });
+    server.registerTool("relay_react_to_message", {
+        title: "React to Relay Message",
+        description: "Add or remove a reaction on a Relay Message part.",
+        inputSchema: reactionInput,
+        annotations: destructiveAnnotations,
+    }, async ({ message_id, operation: reactionOperation, type, custom_emoji, part_index }) => operation(dependencies, (client) => {
+        const body = {
+            operation: reactionOperation,
+            type,
+            ...(custom_emoji ? { custom_emoji } : {}),
+            ...(part_index === undefined ? {} : { part_index }),
+        };
+        return client.messages.addReaction(message_id, body);
+    }));
+    server.registerTool("relay_start_typing", {
+        title: "Start Relay Typing",
+        description: "Start or refresh the Agent typing indicator in a Chat.",
+        inputSchema: z.object({ chat_id: uuid }),
+        annotations: idempotentWriteAnnotations,
+    }, async ({ chat_id }) => operation(dependencies, async (client) => {
+        await client.chats.startTyping(chat_id);
+        return { ok: true };
+    }));
+    server.registerTool("relay_stop_typing", {
+        title: "Stop Relay Typing",
+        description: "Stop the Agent typing indicator in a Chat.",
+        inputSchema: z.object({ chat_id: uuid }),
+        annotations: idempotentWriteAnnotations,
+    }, async ({ chat_id }) => operation(dependencies, async (client) => {
+        await client.chats.stopTyping(chat_id);
+        return { ok: true };
+    }));
+    server.registerTool("relay_mark_chat_read", {
+        title: "Mark Relay Chat Read",
+        description: "Mark the visible Relay Chat as read by the Agent.",
+        inputSchema: z.object({ chat_id: uuid }),
+        annotations: idempotentWriteAnnotations,
+    }, async ({ chat_id }) => operation(dependencies, async (client) => {
+        await client.chats.markAsRead(chat_id);
+        return { ok: true };
+    }));
+    server.registerTool("relay_get_contact_card", {
+        title: "Get Relay Contact Card",
+        description: "Retrieve the authenticated Agent's Relay Contact Card.",
+        inputSchema: z.object({ handle: relayHandle.optional() }),
+        annotations: readAnnotations,
+    }, async ({ handle }) => operation(dependencies, (client) => client.contactCard.retrieve(handle ? { handle } : {})));
+    server.registerTool("relay_set_contact_card", {
+        title: "Set Relay Contact Card",
+        description: "Create or replace the authenticated Agent's Contact Card.",
+        inputSchema: z.object({
+            handle: relayHandle,
+            first_name: z.string().min(1).max(128),
+            last_name: z.string().max(128).optional(),
+            image_url: z.url().optional(),
+        }),
+        annotations: writeAnnotations,
+    }, async ({ handle, first_name, last_name, image_url }) => operation(dependencies, (client) => {
+        const body = {
+            handle,
+            first_name,
+            ...(last_name === undefined ? {} : { last_name }),
+            ...(image_url === undefined ? {} : { image_url }),
+        };
+        return client.contactCard.create(body);
+    }));
+    const updateContactCardInput = z.object({
+        handle: relayHandle,
+        first_name: z.string().min(1).max(128).optional(),
+        last_name: z.string().max(128).nullable().optional(),
+        image_url: z.url().nullable().optional(),
+    }).refine((value) => value.first_name !== undefined
+        || value.last_name !== undefined
+        || value.image_url !== undefined, { message: "At least one Contact Card field must be updated." });
+    server.registerTool("relay_update_contact_card", {
+        title: "Update Relay Contact Card",
+        description: "Update selected fields on the authenticated Agent's Contact Card.",
+        inputSchema: updateContactCardInput,
+        annotations: writeAnnotations,
+    }, async ({ handle, first_name, last_name, image_url }) => operation(dependencies, (client) => {
+        const body = {
+            handle,
+            ...(first_name === undefined ? {} : { first_name }),
+            ...(last_name === undefined ? {} : { last_name }),
+            ...(image_url === undefined ? {} : { image_url }),
+        };
+        return client.contactCard.update(body);
+    }));
+    server.registerTool("relay_share_contact_card", {
+        title: "Share Relay Contact Card",
+        description: "Share the authenticated Agent's configured Contact Card into a Chat.",
+        inputSchema: z.object({ chat_id: uuid }),
+        annotations: writeAnnotations,
+    }, async ({ chat_id }) => operation(dependencies, async (client) => {
+        await client.chats.shareContactCard(chat_id);
+        return { ok: true };
+    }));
+    server.registerTool("relay_create_contact_request", {
+        title: "Create Relay Contact Request",
+        description: "Ask a Relay user to add the authenticated premium-handle Agent.",
+        inputSchema: z.object({ handle: relayHandle }),
+        annotations: writeAnnotations,
+    }, async ({ handle }) => operation(dependencies, (client) => client.contactRequests.create({ handle })));
+    return server;
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@relaymessenger/mcp",
+  "version": "0.1.0-staging.0",
+  "description": "Local MCP v2 stdio server for current Relay messaging tools.",
+  "type": "module",
+  "bin": {
+    "relay-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.js",
+      "default": "./dist/auth.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "contract:check": "node scripts/check-contract.mjs",
+    "boundaries:check": "node scripts/check-boundaries.mjs",
+    "protocol:test": "node scripts/protocol-smoke.mjs",
+    "inspector:test": "node scripts/inspector-smoke.mjs",
+    "pack:smoke": "node scripts/tarball-smoke.mjs",
+    "validate": "npm run clean && npm run check && npm run build && npm test && npm run contract:check && npm run boundaries:check && npm run protocol:test && npm run inspector:test && npm run pack:smoke",
+    "prepack": "npm run validate"
+  },
+  "engines": {
+    "node": ">=22.22.3"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
+    "@relaymessenger/sdk": "0.3.0-staging.4",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
+    "@modelcontextprotocol/inspector": "2.4.0",
+    "@types/node": "^22.18.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "staging",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RelayMessenger/Relay-MCP.git"
+  },
+  "homepage": "https://docs.relayapp.im"
+}