@missionsquad/mcp-msq 0.1.0

package/README.md

@@ -0,0 +1,232 @@
+# @missionsquad/mcp-msq
+
+MCP server interface for the MissionSquad platform API (`https://missionsquad.ai`).
+
+This server exposes MissionSquad account-scoped operations for models, agents, providers, vector stores, files, and core utilities via FastMCP tools.
+
+## Features
+
+- FastMCP stdio server (`mcp-msq`)
+- MissionSquad API key support via hidden tool arg (`apiKey`) or env fallback (`MSQ_API_KEY`)
+- MissionSquad base URL override via hidden tool arg (`baseUrl`) or env fallback (`MSQ_BASE_URL`)
+- Strict TypeScript and Zod-validated tool inputs
+- Multipart file upload support (`POST /v1/files`)
+- Bounded binary file-content retrieval (`GET /v1/files/:id/content`) with truncation metadata
+- Build/test CI and npm publish workflow
+
+## Verified API Coverage
+
+Implemented from `missionsquad-docs/api/index.md` and the following reference pages:
+
+- `chat-completions.md`
+- `embeddings.md`
+- `providers.md`
+- `models.md`
+- `agents.md`
+- `core-utilities.md`
+- `collections.md`
+- `vector-stores.md`
+- `files.md`
+- `convenience.md`
+- `endpoint-index.md`
+
+Current implementation intentionally excludes Webhooks endpoints because the reference only lists routes without request/response contracts.
+
+## Requirements
+
+- Node.js `>=20`
+- Yarn
+
+## Installation
+
+```bash
+yarn install
+yarn build
+yarn start
+```
+
+Run as CLI after install/publish:
+
+```bash
+mcp-msq
+```
+
+## Configuration
+
+Copy `.env.example` to `.env`.
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `MSQ_API_KEY` | No | unset | MissionSquad API key fallback when hidden `apiKey` is not passed |
+| `MSQ_BASE_URL` | No | `https://agents.missionsquad.ai/v1` | Base URL for v1 endpoints |
+| `MSQ_HTTP_TIMEOUT_MS` | No | `30000` | Request timeout in milliseconds |
+| `MSQ_DEFAULT_FILE_CONTENT_MAX_BYTES` | No | `1048576` | Default max bytes returned by `msq_get_file_content` |
+
+## Hidden Arguments
+
+The following are intentionally not in tool schemas and should be passed as hidden extra args:
+
+- `apiKey`: MissionSquad API key for request authentication
+- `baseUrl`: Optional base URL override
+
+Resolution order per request:
+
+1. Hidden extra arg
+2. Environment fallback
+
+If no API key is available, the tool returns a user-facing error.
+
+## Tool Surface
+
+### Core OpenAI-Compatible
+
+- `msq_list_models`
+- `msq_get_model_map`
+- `msq_chat_completions`
+- `msq_embeddings`
+
+### Providers
+
+- `msq_list_providers`
+- `msq_add_provider`
+- `msq_delete_provider`
+
+### Models
+
+- `msq_discover_provider_models`
+- `msq_add_model`
+- `msq_delete_model`
+
+### Agents
+
+- `msq_list_agents`
+- `msq_add_agent`
+- `msq_delete_agent`
+
+### Core Utilities
+
+- `msq_generate_prompt`
+- `msq_run_agent_workflow`
+- `msq_get_core_config`
+- `msq_scrape_url`
+- `msq_list_tools`
+- `msq_list_servers`
+
+### Core Collections
+
+- `msq_list_core_collections`
+- `msq_search_core_collection`
+- `msq_get_core_collection_diagnostics`
+- `msq_recover_core_collection`
+
+### Vector Stores
+
+- `msq_list_vector_stores`
+- `msq_create_vector_store`
+- `msq_get_vector_store`
+- `msq_delete_vector_store`
+- `msq_list_vector_store_files`
+- `msq_add_vector_store_file`
+- `msq_get_vector_store_file`
+- `msq_cancel_vector_store_session`
+
+### Files
+
+- `msq_list_files`
+- `msq_upload_file`
+- `msq_get_file`
+- `msq_delete_file`
+- `msq_get_file_content`
+
+### Convenience
+
+- `msq_list_user_collections`
+- `msq_get_vector_store_file_details`
+
+## File Upload and Download Notes
+
+`msq_upload_file` accepts:
+
+- `filePath` (required)
+- `purpose` (required)
+- `relativePath` (optional)
+- `collectionName` (optional)
+- `filename` (optional override)
+
+`msq_get_file_content` returns:
+
+- `contentType`
+- `contentLength`
+- `bytesRead`
+- `truncated`
+- `base64`
+
+If response content exceeds `maxBytes` (or `MSQ_DEFAULT_FILE_CONTENT_MAX_BYTES`), payload is truncated safely and reported via `truncated: true`.
+
+## Response Format
+
+All tool handlers return deterministic JSON text strings. Parse text content on the client side if structured access is needed.
+
+## Usage Examples
+
+### JSON-RPC tools/call with hidden API key
+
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "msq_list_models",
+    "arguments": {
+      "apiKey": "msq-..."
+    }
+  }
+}
+```
+
+### JSON-RPC tools/call with body args
+
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "msq_chat_completions",
+    "arguments": {
+      "model": "my-gpt4",
+      "messages": [
+        { "role": "user", "content": "Hello" }
+      ],
+      "apiKey": "msq-..."
+    }
+  }
+}
+```
+
+### FastMCP-style client call
+
+```ts
+await client.callTool('msq_embeddings', {
+  model: 'nomic-embed-text-v1.5',
+  input: ['First sentence', 'Second sentence'],
+  apiKey: 'msq-...',
+})
+```
+
+## Development
+
+Scripts:
+
+- `yarn build`
+- `yarn start`
+- `yarn dev`
+- `yarn inspect`
+- `yarn test`
+- `yarn test:coverage`
+
+## CI/CD
+
+- `.github/workflows/build.yaml`: build + test on PR open/sync
+- `.github/workflows/publish.yaml`: build + test + publish on `main` push (markdown-only changes ignored)
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_HTTP_TIMEOUT_MS = 30000;
+export declare const DEFAULT_FILE_CONTENT_MAX_BYTES = 1048576;
+export interface AppConfig {
+    defaultApiKey: string | undefined;
+    defaultBaseUrl: string;
+    httpTimeoutMs: number;
+    defaultFileContentMaxBytes: number;
+}
+export interface ResolvedRequestConfig {
+    apiKey: string;
+    baseUrl: string;
+    httpTimeoutMs: number;
+    defaultFileContentMaxBytes: number;
+}
+export declare const appConfig: AppConfig;
+/**
+ * Resolve authentication and base URL for a request.
+ * Hidden extra args take precedence over environment defaults.
+ */
+export declare function resolveRequestConfig(extraArgs: Record<string, unknown> | undefined, defaults?: AppConfig): ResolvedRequestConfig;

package/dist/config.js

@@ -0,0 +1,77 @@
+import { UserError } from '@missionsquad/fastmcp';
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import { MsqConfigError } from './errors.js';
+dotenv.config();
+const DEFAULT_BASE_URL = 'https://agents.missionsquad.ai/v1';
+const EXPECTED_BASE_PATH_SUFFIX = '/v1';
+export const DEFAULT_HTTP_TIMEOUT_MS = 30_000;
+export const DEFAULT_FILE_CONTENT_MAX_BYTES = 1_048_576;
+const EnvSchema = z.object({
+    MSQ_API_KEY: z.string().optional(),
+    MSQ_BASE_URL: z.string().optional(),
+    MSQ_HTTP_TIMEOUT_MS: z.coerce.number().int().positive().optional(),
+    MSQ_DEFAULT_FILE_CONTENT_MAX_BYTES: z.coerce.number().int().positive().optional(),
+});
+const env = EnvSchema.parse(process.env);
+function normalizeBaseUrl(rawUrl) {
+    const trimmed = rawUrl.trim();
+    if (trimmed.length === 0) {
+        throw new MsqConfigError('MissionSquad base URL must be a non-empty string.');
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new MsqConfigError(`MissionSquad base URL is invalid: ${trimmed}`);
+    }
+    parsed.search = '';
+    parsed.hash = '';
+    const normalizedPath = parsed.pathname.replace(/\/+$/, '') || '/';
+    parsed.pathname = normalizedPath;
+    if (!normalizedPath.endsWith(EXPECTED_BASE_PATH_SUFFIX)) {
+        console.warn(`[mcp-msq] Base URL path "${normalizedPath}" does not end with "${EXPECTED_BASE_PATH_SUFFIX}".` +
+            ' MissionSquad API requests may fail if this is not a v1 API base URL.');
+    }
+    return parsed.toString().replace(/\/$/, '');
+}
+function readHiddenString(extraArgs, key) {
+    const value = extraArgs?.[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new UserError(`Hidden argument "${key}" must be a string when provided.`);
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new UserError(`Hidden argument "${key}" must be a non-empty string when provided.`);
+    }
+    return trimmed;
+}
+export const appConfig = {
+    defaultApiKey: env.MSQ_API_KEY?.trim() || undefined,
+    defaultBaseUrl: normalizeBaseUrl(env.MSQ_BASE_URL ?? DEFAULT_BASE_URL),
+    httpTimeoutMs: env.MSQ_HTTP_TIMEOUT_MS ?? DEFAULT_HTTP_TIMEOUT_MS,
+    defaultFileContentMaxBytes: env.MSQ_DEFAULT_FILE_CONTENT_MAX_BYTES ?? DEFAULT_FILE_CONTENT_MAX_BYTES,
+};
+/**
+ * Resolve authentication and base URL for a request.
+ * Hidden extra args take precedence over environment defaults.
+ */
+export function resolveRequestConfig(extraArgs, defaults = appConfig) {
+    const apiKey = readHiddenString(extraArgs, 'apiKey') ?? defaults.defaultApiKey;
+    if (apiKey === undefined || apiKey.trim().length === 0) {
+        throw new UserError('MissionSquad API key is required. Provide hidden argument "apiKey" or set MSQ_API_KEY.');
+    }
+    const hiddenBaseUrl = readHiddenString(extraArgs, 'baseUrl');
+    const baseUrl = hiddenBaseUrl ? normalizeBaseUrl(hiddenBaseUrl) : defaults.defaultBaseUrl;
+    return {
+        apiKey: apiKey.trim(),
+        baseUrl,
+        httpTimeoutMs: defaults.httpTimeoutMs,
+        defaultFileContentMaxBytes: defaults.defaultFileContentMaxBytes,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+import { UserError } from '@missionsquad/fastmcp';
+export declare class MsqConfigError extends Error {
+    constructor(message: string);
+}
+export declare class MsqTransportError extends Error {
+    constructor(message: string, cause?: unknown);
+}
+export declare class MsqApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly responseBody: unknown;
+    constructor(message: string, status: number, statusText: string, url: string, responseBody: unknown);
+}
+export declare function toUserError(error: unknown, prefix: string): UserError;

package/dist/errors.js

@@ -0,0 +1,75 @@
+import { UserError } from '@missionsquad/fastmcp';
+export class MsqConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MsqConfigError';
+    }
+}
+export class MsqTransportError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'MsqTransportError';
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+    }
+}
+export class MsqApiError extends Error {
+    status;
+    statusText;
+    url;
+    responseBody;
+    constructor(message, status, statusText, url, responseBody) {
+        super(message);
+        this.status = status;
+        this.statusText = statusText;
+        this.url = url;
+        this.responseBody = responseBody;
+        this.name = 'MsqApiError';
+    }
+}
+function messageFromResponseBody(responseBody) {
+    if (typeof responseBody === 'string') {
+        const trimmed = responseBody.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+        return 'No response body.';
+    }
+    if (responseBody === null || typeof responseBody !== 'object') {
+        return 'No response body.';
+    }
+    const record = responseBody;
+    const error = record.error;
+    if (typeof error === 'string' && error.trim().length > 0) {
+        return error;
+    }
+    if (error !== null && typeof error === 'object') {
+        const errorRecord = error;
+        const nestedMessage = errorRecord.message;
+        if (typeof nestedMessage === 'string' && nestedMessage.trim().length > 0) {
+            return nestedMessage;
+        }
+    }
+    const message = record.message;
+    if (typeof message === 'string' && message.trim().length > 0) {
+        return message;
+    }
+    return 'No response body.';
+}
+export function toUserError(error, prefix) {
+    if (error instanceof UserError) {
+        return error;
+    }
+    if (error instanceof MsqApiError) {
+        const bodyMessage = messageFromResponseBody(error.responseBody);
+        return new UserError(`${prefix}: MissionSquad API returned ${error.status} ${error.statusText}. ${bodyMessage}`);
+    }
+    if (error instanceof MsqConfigError || error instanceof MsqTransportError) {
+        return new UserError(`${prefix}: ${error.message}`);
+    }
+    if (error instanceof Error) {
+        return new UserError(`${prefix}: ${error.message}`);
+    }
+    return new UserError(`${prefix}: ${String(error)}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { FastMCP } from '@missionsquad/fastmcp';
+import { routeConsoleStdoutToStderr } from './stdio-safe-console.js';
+import { registerMissionSquadTools } from './tools.js';
+routeConsoleStdoutToStderr();
+const server = new FastMCP({
+    name: 'mcp-msq',
+    version: '0.1.0',
+});
+registerMissionSquadTools(server);
+async function main() {
+    await server.start({ transportType: 'stdio' });
+}
+async function shutdown(exitCode) {
+    try {
+        await server.stop();
+    }
+    finally {
+        process.exit(exitCode);
+    }
+}
+process.on('SIGINT', () => {
+    void shutdown(0);
+});
+process.on('SIGTERM', () => {
+    void shutdown(0);
+});
+process.on('uncaughtException', () => {
+    void shutdown(1);
+});
+process.on('unhandledRejection', () => {
+    void shutdown(1);
+});
+void main().catch(() => {
+    void shutdown(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,0BAA0B,EAAE,CAAA;AAE5B,MAAM,MAAM,GAAG,IAAI,OAAO,CAAY;IACpC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,yBAAyB,CAAC,MAAM,CAAC,CAAA;AAEjC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC;AACH,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACnC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACpC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA;AAEF,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;IACrB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA"}

package/dist/json.d.ts

@@ -0,0 +1,4 @@
+/**
+ * MCP tools commonly return a string payload. This keeps output deterministic.
+ */
+export declare function stringifyResult(value: unknown): string;

package/dist/json.js

@@ -0,0 +1,13 @@
+/**
+ * MCP tools commonly return a string payload. This keeps output deterministic.
+ */
+export function stringifyResult(value) {
+    const result = JSON.stringify(value, (_key, currentValue) => {
+        if (typeof currentValue === 'bigint') {
+            return currentValue.toString();
+        }
+        return currentValue;
+    }, 2);
+    return result ?? 'null';
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAC3B,KAAK,EACL,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE;QACrB,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAA;QAChC,CAAC;QACD,OAAO,YAAY,CAAA;IACrB,CAAC,EACD,CAAC,CACF,CAAA;IAED,OAAO,MAAM,IAAI,MAAM,CAAA;AACzB,CAAC"}

package/dist/msq-client.d.ts

@@ -0,0 +1,42 @@
+import { type ResolvedRequestConfig } from './config.js';
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+interface JsonRequestOptions {
+    method: HttpMethod;
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    headers?: Record<string, string | undefined>;
+}
+interface FileUploadOptions {
+    filePath: string;
+    purpose: string;
+    relativePath?: string;
+    collectionName?: string;
+    filename?: string;
+}
+interface FileContentRequestOptions {
+    fileId: string;
+    maxBytes?: number;
+}
+interface FileContentResult {
+    contentType: string | null;
+    contentLength: number | null;
+    bytesRead: number;
+    truncated: boolean;
+    base64: string;
+}
+export declare class MissionSquadClient {
+    private readonly requestConfig;
+    constructor(requestConfig: ResolvedRequestConfig);
+    requestJson(options: JsonRequestOptions): Promise<unknown>;
+    uploadFile(options: FileUploadOptions): Promise<unknown>;
+    getFileContent(options: FileContentRequestOptions): Promise<FileContentResult>;
+    private buildUrl;
+    private compactHeaders;
+    private fetchWithTimeout;
+    private parseStructuredResponse;
+    private parseResponseBody;
+    private parseErrorPayload;
+}
+export declare function createMissionSquadClient(extraArgs: Record<string, unknown> | undefined): MissionSquadClient;
+export {};