@one-source/api-mcp 1.0.0

package/dist/cli.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for onesource-api-mcp.
+ *
+ * Usage:
+ *   npx onesource-api-mcp           # stdio mode (default)
+ *   npx onesource-api-mcp --http    # HTTP server on port 3002
+ *   npx onesource-api-mcp --http --port=8080
+ */
+import { createMcpServer, VERSION } from './create-server.js';
+import { createClientFromEnv } from './client.js';
+import { createAnalytics } from './analytics.js';
+const args = process.argv.slice(2);
+if (args.includes('--http')) {
+    // Parse --port=N or --port N
+    const portArgIdx = args.findIndex((a) => a === '--port' || a.startsWith('--port='));
+    let port = 3002;
+    if (portArgIdx !== -1) {
+        const arg = args[portArgIdx];
+        const portStr = arg.startsWith('--port=')
+            ? arg.split('=')[1]
+            : args[portArgIdx + 1];
+        const parsed = parseInt(portStr ?? '', 10);
+        if (!portStr || isNaN(parsed) || parsed < 1 || parsed > 65535) {
+            console.error(`Error: Invalid port "${portStr ?? ''}". Must be between 1 and 65535.`);
+            process.exit(1);
+        }
+        port = parsed;
+    }
+    const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
+    const { createServer } = await import('node:http');
+    // Shared client + analytics — reused across requests
+    const sharedClient = createClientFromEnv();
+    const sharedAnalytics = createAnalytics();
+    const httpServer = createServer(async (req, res) => {
+        if (req.url === '/mcp' && req.method === 'POST') {
+            // Fresh server per request (SDK stateless pattern), shared client + analytics
+            const { server } = createMcpServer({ client: sharedClient, analytics: sharedAnalytics, transport: 'http' });
+            const httpTransport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            try {
+                await server.connect(httpTransport);
+                await httpTransport.handleRequest(req, res);
+            }
+            catch {
+                if (!res.headersSent) {
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({
+                        jsonrpc: '2.0',
+                        error: { code: -32603, message: 'Internal server error' },
+                        id: null,
+                    }));
+                }
+            }
+            // Cleanup when response stream closes
+            res.on('close', () => {
+                httpTransport.close();
+                server.close();
+            });
+        }
+        else if (req.url === '/mcp' && (req.method === 'GET' || req.method === 'DELETE')) {
+            // MCP protocol: 405 for non-POST in stateless mode
+            res.writeHead(405, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                error: { code: -32000, message: 'Method not allowed in stateless mode' },
+                id: null,
+            }));
+        }
+        else if (req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end('{"status":"ok"}');
+        }
+        else {
+            res.writeHead(404);
+            res.end('Not found');
+        }
+    });
+    // Bind to localhost by default (don't expose to network)
+    httpServer.listen(port, '127.0.0.1', () => {
+        console.error(`[onesource-api] HTTP server listening on http://127.0.0.1:${port}`);
+        console.error(`[onesource-api] MCP endpoint: http://127.0.0.1:${port}/mcp`);
+    });
+    sharedAnalytics.trackService({
+        type: 'service_start',
+        service: 'onesource-api',
+        timestamp: new Date().toISOString(),
+        version: VERSION,
+        details: `http:${port}`,
+    });
+    // Graceful shutdown — flush analytics before exit
+    process.once('SIGINT', async () => {
+        sharedAnalytics.trackService({
+            type: 'service_stop',
+            service: 'onesource-api',
+            timestamp: new Date().toISOString(),
+            version: VERSION,
+        });
+        sharedAnalytics.stop();
+        await Promise.race([
+            (async () => {
+                await sharedAnalytics.flush();
+                await new Promise((resolve) => httpServer.close(() => resolve()));
+            })(),
+            new Promise((resolve) => setTimeout(resolve, 5_000)),
+        ]);
+        process.exit(0);
+    });
+}
+else {
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { server, analytics } = createMcpServer({ transport: 'stdio' });
+    const stdioTransport = new StdioServerTransport();
+    await server.connect(stdioTransport);
+    console.error('[onesource-api] Server connected via stdio');
+    analytics.trackService({
+        type: 'service_start',
+        service: 'onesource-api',
+        timestamp: new Date().toISOString(),
+        version: VERSION,
+        details: 'stdio',
+    });
+    // Graceful shutdown
+    process.once('SIGINT', async () => {
+        analytics.trackService({
+            type: 'service_stop',
+            service: 'onesource-api',
+            timestamp: new Date().toISOString(),
+            version: VERSION,
+        });
+        analytics.stop();
+        await Promise.race([
+            (async () => {
+                await analytics.flush();
+                stdioTransport.close();
+                await server.close();
+            })(),
+            new Promise((resolve) => setTimeout(resolve, 5_000)),
+        ]);
+        process.exit(0);
+    });
+}
+//# 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;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5B,6BAA6B;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CACjD,CAAC;IACF,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YACvC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;YAC9D,OAAO,CAAC,KAAK,CACX,wBAAwB,OAAO,IAAI,EAAE,iCAAiC,CACvE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,GAAG,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,6BAA6B,EAAE,GAAG,MAAM,MAAM,CACpD,oDAAoD,CACrD,CAAC;IACF,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnD,qDAAqD;IACrD,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,eAAe,GAAG,eAAe,EAAE,CAAC;IAE1C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjD,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAChD,8EAA8E;YAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5G,MAAM,aAAa,GAAG,IAAI,6BAA6B,CAAC;gBACtD,kBAAkB,EAAE,SAAS;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACpC,MAAM,aAAa,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;oBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;wBACrB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE;wBACzD,EAAE,EAAE,IAAI;qBACT,CAAC,CAAC,CAAC;gBACN,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,aAAa,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QAEL,CAAC;aAAM,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACnF,mDAAmD;YACnD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE;gBACxE,EAAE,EAAE,IAAI;aACT,CAAC,CAAC,CAAC;QAEN,CAAC;aAAM,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAE7B,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yDAAyD;IACzD,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,6DAA6D,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,kDAAkD,IAAI,MAAM,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,eAAe,CAAC,YAAY,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,QAAQ,IAAI,EAAE;KACxB,CAAC,CAAC;IAEH,kDAAkD;IAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAChC,eAAe,CAAC,YAAY,CAAC;YAC3B,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,eAAe;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,CAAC,KAAK,IAAI,EAAE;gBACV,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1E,CAAC,CAAC,EAAE;YACJ,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SAC3D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AAEL,CAAC;KAAM,CAAC;IACN,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAClD,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAE5D,SAAS,CAAC,YAAY,CAAC;QACrB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB;IACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAChC,SAAS,CAAC,YAAY,CAAC;YACrB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,eAAe;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,CAAC,KAAK,IAAI,EAAE;gBACV,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;gBACxB,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC,CAAC,EAAE;YACJ,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SAC3D,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * HTTP client for the OneSource Skills REST API.
+ *
+ * All 34 MCP tools delegate to this client, which handles:
+ * - Base URL configuration
+ * - x402 payment flow (402 → sign → retry)
+ * - Response envelope unwrapping
+ */
+export type { ApiResponse } from './types.js';
+import type { ApiResponse } from './types.js';
+export interface ClientOptions {
+    baseUrl: string;
+}
+export interface HttpEventData {
+    tool: string;
+    http_status: number;
+    backend_latency_ms: number;
+    x402_required: boolean;
+}
+export interface CallContext {
+    tool: string;
+}
+export declare class OneSourceClient {
+    private baseUrl;
+    private _context;
+    /** Set by create-server.ts to receive HTTP-level metrics. */
+    onHttpEvent?: (event: HttpEventData) => void;
+    constructor(opts: ClientOptions);
+    /**
+     * Create a child client with call context (e.g. tool name).
+     * The child shares the same baseUrl and onHttpEvent but has its own context.
+     * Safe for concurrent use — each tool call gets its own child.
+     */
+    withContext(ctx: CallContext): OneSourceClient;
+    /**
+     * GET request to the Skills API.
+     */
+    get<T = unknown>(path: string, params?: Record<string, string | number | undefined>): Promise<ApiResponse<T>>;
+    /**
+     * POST request to the Skills API.
+     */
+    post<T = unknown>(path: string, body: Record<string, unknown>, params?: Record<string, string | number | undefined>): Promise<ApiResponse<T>>;
+    private fetchWithMetrics;
+    private buildUrl;
+    private headers;
+    private handleResponse;
+}
+/**
+ * Create a client from environment variables.
+ */
+export declare function createClientFromEnv(): OneSourceClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAA6B;IAE7C,6DAA6D;IAC7D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;gBAEjC,IAAI,EAAE,aAAa;IAK/B;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe;IAM9C;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GACnD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAS1B;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GACnD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAUZ,gBAAgB;IAoB9B,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,OAAO;YAID,cAAc;CA4C7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,CAQrD"}

package/dist/client.js

@@ -0,0 +1,126 @@
+export class OneSourceClient {
+    baseUrl;
+    _context = { tool: '' };
+    /** Set by create-server.ts to receive HTTP-level metrics. */
+    onHttpEvent;
+    constructor(opts) {
+        // Strip trailing slash
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+    }
+    /**
+     * Create a child client with call context (e.g. tool name).
+     * The child shares the same baseUrl and onHttpEvent but has its own context.
+     * Safe for concurrent use — each tool call gets its own child.
+     */
+    withContext(ctx) {
+        const child = Object.create(this);
+        child._context = ctx;
+        return child;
+    }
+    /**
+     * GET request to the Skills API.
+     */
+    async get(path, params) {
+        const url = this.buildUrl(path, params);
+        const { res, latencyMs } = await this.fetchWithMetrics(url.toString(), {
+            method: 'GET',
+            headers: this.headers(),
+        });
+        return this.handleResponse(res, latencyMs);
+    }
+    /**
+     * POST request to the Skills API.
+     */
+    async post(path, body, params) {
+        const url = this.buildUrl(path, params);
+        const { res, latencyMs } = await this.fetchWithMetrics(url.toString(), {
+            method: 'POST',
+            headers: { ...this.headers(), 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(res, latencyMs);
+    }
+    async fetchWithMetrics(url, init) {
+        const start = performance.now();
+        try {
+            const res = await fetch(url, init);
+            return { res, latencyMs: Math.round(performance.now() - start) };
+        }
+        catch (err) {
+            const latencyMs = Math.round(performance.now() - start);
+            this.onHttpEvent?.({
+                tool: this._context.tool,
+                http_status: 0,
+                backend_latency_ms: latencyMs,
+                x402_required: false,
+            });
+            throw err;
+        }
+    }
+    buildUrl(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url;
+    }
+    headers() {
+        return { 'User-Agent': 'onesource-api-mcp' };
+    }
+    async handleResponse(res, latencyMs) {
+        // Fire HTTP analytics callback
+        this.onHttpEvent?.({
+            tool: this._context.tool,
+            http_status: res.status,
+            backend_latency_ms: latencyMs,
+            x402_required: res.status === 402,
+        });
+        // x402 payment required — return a helpful message instead of crashing
+        if (res.status === 402) {
+            const paymentHeader = res.headers.get('Payment-Required');
+            const details = paymentHeader ? ` Details: ${paymentHeader.slice(0, 200)}` : '';
+            return {
+                error: `Payment required (402). This endpoint requires x402 payment.${details}`,
+            };
+        }
+        // Parse response body safely — upstream may return HTML error pages or empty bodies
+        let body;
+        try {
+            const text = await res.text();
+            body = JSON.parse(text);
+        }
+        catch {
+            return {
+                error: `Failed to parse response (HTTP ${res.status}): body was not valid JSON`,
+            };
+        }
+        if (body === null || typeof body !== 'object') {
+            return {
+                error: `Unexpected response shape (HTTP ${res.status})`,
+            };
+        }
+        if (!res.ok) {
+            return {
+                error: body.error ?? `HTTP ${res.status}: ${res.statusText}`,
+                meta: body.meta,
+            };
+        }
+        return body;
+    }
+}
+/**
+ * Create a client from environment variables.
+ */
+export function createClientFromEnv() {
+    const baseUrl = process.env.ONESOURCE_BASE_URL ?? 'https://skills.onesource.io';
+    const parsed = new URL(baseUrl);
+    if (!['https:', 'http:'].includes(parsed.protocol)) {
+        throw new Error('ONESOURCE_BASE_URL must use http or https');
+    }
+    return new OneSourceClient({ baseUrl });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/create-server.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MCP Server Factory
+ *
+ * Creates a configured McpServer with all OneSource API tools.
+ * Shared by stdio (cli.ts) and HTTP modes.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OneSourceClient } from './client.js';
+import { type Analytics } from './analytics.js';
+export declare const VERSION: string;
+export interface CreateServerOptions {
+    /** Override the default client (useful for testing). */
+    client?: OneSourceClient;
+    /** Override the default analytics (useful for testing). */
+    analytics?: Analytics;
+    /** Transport mode — passed through to analytics events. */
+    transport?: 'stdio' | 'http';
+}
+/**
+ * Create a configured MCP server with all OneSource API tools.
+ */
+export declare function createMcpServer(opts?: CreateServerOptions): {
+    server: McpServer;
+    analytics: Analytics;
+};
+export type CreateServerResult = ReturnType<typeof createMcpServer>;
+export { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+//# sourceMappingURL=create-server.d.ts.map

package/dist/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../src/create-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAuB,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjE,eAAO,MAAM,OAAO,EAAE,MAA2C,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAwHvG;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAGpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/create-server.js

@@ -0,0 +1,133 @@
+/**
+ * MCP Server Factory
+ *
+ * Creates a configured McpServer with all OneSource API tools.
+ * Shared by stdio (cli.ts) and HTTP modes.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
+import { createClientFromEnv } from './client.js';
+import { allTools } from './tools/index.js';
+import { createAnalytics } from './analytics.js';
+const require = createRequire(import.meta.url);
+export const VERSION = require('../package.json').version;
+function hashSession(sessionId) {
+    if (!sessionId)
+        return undefined;
+    return createHash('sha256').update(sessionId).digest('hex').slice(0, 16);
+}
+/**
+ * Create a configured MCP server with all OneSource API tools.
+ */
+export function createMcpServer(opts) {
+    const client = opts?.client ?? createClientFromEnv();
+    const analytics = opts?.analytics ?? createAnalytics();
+    const transport = opts?.transport;
+    // Wire HTTP-level analytics from client (default handler for non-overridden calls)
+    client.onHttpEvent = (event) => {
+        analytics.trackHttp({
+            type: 'http_call',
+            service: 'onesource-api',
+            tool: event.tool,
+            http_status: event.http_status,
+            backend_latency_ms: event.backend_latency_ms,
+            x402_required: event.x402_required,
+            timestamp: new Date().toISOString(),
+        });
+    };
+    const server = new McpServer({
+        name: 'onesource-api',
+        version: VERSION,
+    });
+    // Register all tools with analytics instrumentation
+    for (const tool of allTools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.schema,
+        }, async (input, extra) => {
+            const start = performance.now();
+            const inputRecord = input;
+            const inputKeys = Object.keys(inputRecord);
+            const network = inputRecord.network;
+            const sessionHash = hashSession(extra.sessionId);
+            const clientInfo = server.server.getClientVersion();
+            // Create a per-call client with tool context (avoids race condition on shared client)
+            const toolClient = client.withContext({ tool: tool.name });
+            // Track x402 status per-call via closure — no shared mutable state
+            let x402Seen = false;
+            toolClient.onHttpEvent = (event) => {
+                if (event.x402_required)
+                    x402Seen = true;
+                analytics.trackHttp({
+                    type: 'http_call',
+                    service: 'onesource-api',
+                    tool: event.tool,
+                    http_status: event.http_status,
+                    backend_latency_ms: event.backend_latency_ms,
+                    x402_required: event.x402_required,
+                    timestamp: new Date().toISOString(),
+                    session_id: sessionHash,
+                });
+            };
+            try {
+                const text = await tool.handler(inputRecord, toolClient);
+                const durationMs = Math.round(performance.now() - start);
+                analytics.trackTool({
+                    type: 'tool_call',
+                    service: 'onesource-api',
+                    tool: tool.name,
+                    category: tool.category,
+                    timestamp: new Date().toISOString(),
+                    duration_ms: durationMs,
+                    success: true,
+                    network,
+                    input_params: inputKeys,
+                    response_size: text.length,
+                    version: VERSION,
+                    auth_method: x402Seen ? 'x402' : 'none',
+                    client_name: clientInfo?.name,
+                    client_version: clientInfo?.version,
+                    session_id: sessionHash,
+                    transport,
+                });
+                return {
+                    content: [{ type: 'text', text }],
+                };
+            }
+            catch (err) {
+                const durationMs = Math.round(performance.now() - start);
+                const message = err instanceof Error ? err.message : String(err);
+                analytics.trackTool({
+                    type: 'tool_call',
+                    service: 'onesource-api',
+                    tool: tool.name,
+                    category: tool.category,
+                    timestamp: new Date().toISOString(),
+                    duration_ms: durationMs,
+                    success: false,
+                    error_category: message.slice(0, 100).replace(/0x[a-fA-F0-9]+/g, '0x***'),
+                    network,
+                    input_params: inputKeys,
+                    response_size: 0,
+                    version: VERSION,
+                    auth_method: x402Seen ? 'x402' : 'none',
+                    client_name: clientInfo?.name,
+                    client_version: clientInfo?.version,
+                    session_id: sessionHash,
+                    transport,
+                });
+                return {
+                    isError: true,
+                    content: [
+                        { type: 'text', text: `Tool error: ${message.slice(0, 500)}` },
+                    ],
+                };
+            }
+        });
+    }
+    return { server, analytics };
+}
+// Re-export for consumers that need transports
+export { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+//# sourceMappingURL=create-server.js.map

package/dist/create-server.js.map

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

package/dist/tools/chain/contract-code.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 1s_contract_code — Get the deployed bytecode of a contract.
+ */
+import type { ToolDef } from '../../types.js';
+export declare const tool: ToolDef;
+//# sourceMappingURL=contract-code.d.ts.map

package/dist/tools/chain/contract-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-code.d.ts","sourceRoot":"","sources":["../../../src/tools/chain/contract-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAiBlB,CAAC"}

package/dist/tools/chain/contract-code.js

@@ -0,0 +1,19 @@
+import { networkParam, addressParam, formatResponse, safePath } from '../../types.js';
+export const tool = {
+    name: '1s_contract_code',
+    description: 'Get the deployed bytecode of a contract via eth_getCode. ' +
+        "Returns '0x' for EOA (non-contract) addresses. " +
+        'Use this to verify whether an address is a contract before interacting with it.',
+    category: 'chain',
+    schema: {
+        address: addressParam,
+        network: networkParam,
+    },
+    handler: async (input, client) => {
+        const res = await client.get(`/api/chain/code/${safePath(input.address)}`, {
+            network: input.network,
+        });
+        return formatResponse(res);
+    },
+};
+//# sourceMappingURL=contract-code.js.map

package/dist/tools/chain/contract-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-code.js","sourceRoot":"","sources":["../../../src/tools/chain/contract-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtF,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,2DAA2D;QAC3D,iDAAiD;QACjD,iFAAiF;IACnF,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE;QACN,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,KAAK,CAAC,OAAiB,CAAC,EAAE,EAAE;YACnF,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/dist/tools/chain/ens-resolve.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../../types.js';
+export declare const tool: ToolDef;
+//# sourceMappingURL=ens-resolve.d.ts.map

package/dist/tools/chain/ens-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens-resolve.d.ts","sourceRoot":"","sources":["../../../src/tools/chain/ens-resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OAsBlB,CAAC"}

package/dist/tools/chain/ens-resolve.js

@@ -0,0 +1,25 @@
+/**
+ * 1s_ens_resolve — Resolve ENS names to addresses or addresses to ENS names.
+ */
+import { z } from 'zod';
+import { networkParam, formatResponse, safePath } from '../../types.js';
+export const tool = {
+    name: '1s_ens_resolve',
+    description: 'Resolve ENS names to addresses (forward) or addresses to ENS names (reverse). ' +
+        "Accepts either a .eth name or a 0x address. " +
+        'Only works on networks with ENS registry deployed (mainnet, sepolia).',
+    category: 'chain',
+    schema: {
+        input: z.string()
+            .regex(/^(0x[a-fA-F0-9]{40}|[a-zA-Z0-9]([a-zA-Z0-9._-]*[a-zA-Z0-9])?)$/, 'Must be an ENS name (e.g. vitalik.eth) or 0x address')
+            .describe("ENS name (e.g. 'vitalik.eth') or address (0x...) for reverse lookup"),
+        network: networkParam,
+    },
+    handler: async (input, client) => {
+        const res = await client.get(`/api/chain/ens/${safePath(input.input)}`, {
+            network: input.network,
+        });
+        return formatResponse(res);
+    },
+};
+//# sourceMappingURL=ens-resolve.js.map

package/dist/tools/chain/ens-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens-resolve.js","sourceRoot":"","sources":["../../../src/tools/chain/ens-resolve.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExE,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,gFAAgF;QAChF,8CAA8C;QAC9C,uEAAuE;IACzE,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;aACd,KAAK,CACJ,gEAAgE,EAChE,sDAAsD,CACvD;aACA,QAAQ,CAAC,qEAAqE,CAAC;QAClF,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,QAAQ,CAAC,KAAK,CAAC,KAAe,CAAC,EAAE,EAAE;YAChF,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/dist/tools/chain/estimate-gas.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 1s_estimate_gas — Estimate gas required for a transaction.
+ */
+import type { ToolDef } from '../../types.js';
+export declare const tool: ToolDef;
+//# sourceMappingURL=estimate-gas.d.ts.map

package/dist/tools/chain/estimate-gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-gas.d.ts","sourceRoot":"","sources":["../../../src/tools/chain/estimate-gas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,eAAO,MAAM,IAAI,EAAE,OA2BlB,CAAC"}

package/dist/tools/chain/estimate-gas.js

@@ -0,0 +1,31 @@
+import { networkParam, addressParam, formatResponse, optionalHexParam } from '../../types.js';
+export const tool = {
+    name: '1s_estimate_gas',
+    description: 'Estimate gas required for a transaction via eth_estimateGas. ' +
+        'Use this before sending transactions to set appropriate gas limits. ' +
+        'Returns the estimated gas as a hex value; reverts return the revert reason.',
+    category: 'chain',
+    schema: {
+        to: addressParam,
+        data: optionalHexParam.describe('ABI-encoded call data (hex)'),
+        from: addressParam.optional().describe('Sender address'),
+        value: optionalHexParam.describe('ETH value in wei (hex)'),
+        network: networkParam,
+    },
+    handler: async (input, client) => {
+        const body = {
+            to: input.to,
+        };
+        if (input.data !== undefined)
+            body.data = input.data;
+        if (input.from !== undefined)
+            body.from = input.from;
+        if (input.value !== undefined)
+            body.value = input.value;
+        const res = await client.post('/api/chain/estimate-gas', body, {
+            network: input.network,
+        });
+        return formatResponse(res);
+    },
+};
+//# sourceMappingURL=estimate-gas.js.map

package/dist/tools/chain/estimate-gas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-gas.js","sourceRoot":"","sources":["../../../src/tools/chain/estimate-gas.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9F,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,+DAA+D;QAC/D,sEAAsE;QACtE,6EAA6E;IAC/E,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE;QACN,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC9D,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACxD,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC1D,OAAO,EAAE,YAAY;KACtB;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,IAAI,GAA4B;YACpC,EAAE,EAAE,KAAK,CAAC,EAAE;SACb,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACrD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAExD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,IAAI,EAAE;YAC7D,OAAO,EAAE,KAAK,CAAC,OAA6B;SAC7C,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}