@one-source/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2026 BlockParty. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. No part of the Software may be reproduced, distributed, or
+transmitted in any form or by any means without the prior written permission of
+BlockParty.
+
+Unauthorized copying, modification, distribution, or use of this Software,
+via any medium, is strictly prohibited.

package/dist/analytics.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Unified analytics wrapper.
+ *
+ * Uses api-mcp's analytics implementation (superset — includes trackHttp which
+ * docs-mcp lacks) and widens ToolCallEvent.category to include 'docs'.
+ * The underlying implementations (Noop/Stderr/Dashboard) serialize events to
+ * JSON, so the wider category type is safe at runtime.
+ */
+import { type Analytics as _Analytics, type ToolCallEvent as _ToolCallEvent, type HttpCallEvent, type ServiceEvent } from '@one-source/api-mcp/analytics';
+/** ToolCallEvent with category widened to include docs tools. */
+export type ToolCallEvent = Omit<_ToolCallEvent, 'category'> & {
+    category: _ToolCallEvent['category'] | 'docs';
+};
+/** Analytics interface with trackTool accepting the widened ToolCallEvent. */
+export interface Analytics extends Omit<_Analytics, 'trackTool'> {
+    trackTool(event: ToolCallEvent): void;
+}
+/** Create an analytics instance (Noop, Stderr, or Dashboard based on env vars). */
+export declare function createAnalytics(): Analytics;
+export type { HttpCallEvent, ServiceEvent };
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,aAAa,IAAI,cAAc,EACpC,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AAEvC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IAC7D,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;CAC/C,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;IAC9D,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACvC;AAED,mFAAmF;AACnF,wBAAgB,eAAe,IAAI,SAAS,CAE3C;AAED,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC"}

package/dist/analytics.js

@@ -0,0 +1,14 @@
+/**
+ * Unified analytics wrapper.
+ *
+ * Uses api-mcp's analytics implementation (superset — includes trackHttp which
+ * docs-mcp lacks) and widens ToolCallEvent.category to include 'docs'.
+ * The underlying implementations (Noop/Stderr/Dashboard) serialize events to
+ * JSON, so the wider category type is safe at runtime.
+ */
+import { createAnalytics as _createAnalytics, } from '@one-source/api-mcp/analytics';
+/** Create an analytics instance (Noop, Stderr, or Dashboard based on env vars). */
+export function createAnalytics() {
+    return _createAnalytics();
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,IAAI,gBAAgB,GAKpC,MAAM,+BAA+B,CAAC;AAYvC,mFAAmF;AACnF,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,EAAe,CAAC;AACzC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for onesource-mcp (unified server).
+ *
+ * Usage:
+ *   npx onesource-mcp             # stdio mode (default)
+ *   npx onesource-mcp --http      # HTTP server on port 3000
+ *   npx onesource-mcp --http --port=8080
+ */
+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":";AACA;;;;;;;GAOG;AA0LH,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for onesource-mcp (unified server).
+ *
+ * Usage:
+ *   npx onesource-mcp             # stdio mode (default)
+ *   npx onesource-mcp --http      # HTTP server on port 3000
+ *   npx onesource-mcp --http --port=8080
+ */
+const args = process.argv.slice(2);
+if (args.includes('--http')) {
+    // ---------- HTTP mode ----------
+    // Parse --port=N or --port N
+    const portArgIdx = args.findIndex((a) => a === '--port' || a.startsWith('--port='));
+    let port = 3000;
+    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');
+    const { createMcpServer, loadData, VERSION } = await import('./create-server.js');
+    const { createAnalytics } = await import('./analytics.js');
+    const { createClientFromEnv } = await import('@one-source/api-mcp/client');
+    // Pre-load docs data once at startup
+    const docsData = loadData();
+    // Shared singletons — reused across stateless per-request servers
+    const sharedAnalytics = createAnalytics();
+    const sharedClient = createClientFromEnv();
+    const httpServer = createServer(async (req, res) => {
+        // CORS headers
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, mcp-session-id');
+        // CORS preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204).end();
+            return;
+        }
+        // Health check
+        if (req.method === 'GET' && req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                status: 'ok',
+                server: 'onesource-mcp',
+                version: VERSION,
+                tools: 43,
+            }));
+            return;
+        }
+        // MCP only accepts POST (stateless mode)
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                jsonrpc: '2.0',
+                error: { code: -32000, message: 'Method not allowed' },
+                id: null,
+            }));
+            return;
+        }
+        // Fresh server per request (SDK stateless pattern), shared singletons
+        const { server } = createMcpServer({
+            docsData,
+            analytics: sharedAnalytics,
+            client: sharedClient,
+            transport: 'http',
+        });
+        const httpTransport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        // Register cleanup before handleRequest so it runs even if handleRequest throws
+        res.on('close', () => {
+            httpTransport.close();
+            server.close();
+        });
+        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,
+                }));
+            }
+        }
+    });
+    // Bind to localhost only — no network exposure
+    httpServer.listen(port, '127.0.0.1', () => {
+        console.error(`[onesource] HTTP server listening on http://127.0.0.1:${port}`);
+        console.error(`[onesource] MCP endpoint: POST http://127.0.0.1:${port}/`);
+        console.error(`[onesource] Health: GET http://127.0.0.1:${port}/health`);
+    });
+    sharedAnalytics.trackService({
+        type: 'service_start',
+        service: 'onesource',
+        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',
+            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 {
+    // ---------- Stdio mode (default) ----------
+    const { createMcpServer, VERSION } = await import('./create-server.js');
+    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] Server connected via stdio');
+    analytics.trackService({
+        type: 'service_start',
+        service: 'onesource',
+        timestamp: new Date().toISOString(),
+        version: VERSION,
+        details: 'stdio',
+    });
+    // Graceful shutdown — flush analytics before exit
+    process.once('SIGINT', async () => {
+        analytics.trackService({
+            type: 'service_stop',
+            service: 'onesource',
+            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);
+    });
+}
+export {};
+//# 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;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5B,kCAAkC;IAElC,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;IACnD,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAClF,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAE3E,qCAAqC;IACrC,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAE5B,kEAAkE;IAClE,MAAM,eAAe,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjD,eAAe;QACf,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,oBAAoB,CAAC,CAAC;QACpE,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,8BAA8B,CAAC,CAAC;QAE9E,iBAAiB;QACjB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,eAAe;QACf,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAClD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,eAAe;gBACvB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,EAAE;aACV,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QAED,yCAAyC;QACzC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1B,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,oBAAoB,EAAE;gBACtD,EAAE,EAAE,IAAI;aACT,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QAED,sEAAsE;QACtE,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;YACjC,QAAQ;YACR,SAAS,EAAE,eAAe;YAC1B,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,6BAA6B,CAAC;YACtD,kBAAkB,EAAE,SAAS;SAC9B,CAAC,CAAC;QAEH,gFAAgF;QAChF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,aAAa,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACpC,MAAM,aAAa,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACrB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE;oBACzD,EAAE,EAAE,IAAI;iBACT,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,KAAK,CAAC,mDAAmD,IAAI,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,KAAK,CAAC,4CAA4C,IAAI,SAAS,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,eAAe,CAAC,YAAY,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,WAAW;QACpB,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,WAAW;YACpB,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,6CAA6C;IAE7C,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACxE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IAEF,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,wCAAwC,CAAC,CAAC;IAExD,SAAS,CAAC,YAAY,CAAC;QACrB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,kDAAkD;IAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAChC,SAAS,CAAC,YAAY,CAAC;YACrB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,WAAW;YACpB,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/create-server.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Unified MCP Server Factory
+ *
+ * Creates a single McpServer named 'onesource' with all 43 tools
+ * (34 API + 9 docs) by delegating to the two register modules.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { OneSourceClient } from '@one-source/api-mcp/client';
+import { loadData, type LoadedData } from './register-docs-tools.js';
+import { type Analytics } from './analytics.js';
+import { VERSION } from './version.js';
+export interface CreateServerOptions {
+    /** Pre-loaded docs content (avoids re-reading files per request in HTTP mode). */
+    docsData?: LoadedData;
+    /** Override the default analytics instance (for sharing across HTTP requests). */
+    analytics?: Analytics;
+    /** Override the default API client (for sharing across HTTP requests). */
+    client?: OneSourceClient;
+    /** Transport mode — passed through to analytics events. */
+    transport?: 'stdio' | 'http';
+}
+export interface CreateServerResult {
+    server: McpServer;
+    analytics: Analytics;
+    client: OneSourceClient;
+    toolCount: number;
+}
+/**
+ * Create a unified MCP server with all OneSource tools.
+ */
+export declare function createMcpServer(opts?: CreateServerOptions): CreateServerResult;
+export { loadData, type LoadedData };
+export { VERSION };
+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;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAqB,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,kFAAkF;IAClF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,CAwB9E;AAED,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/create-server.js

@@ -0,0 +1,39 @@
+/**
+ * Unified MCP Server Factory
+ *
+ * Creates a single McpServer named 'onesource' with all 43 tools
+ * (34 API + 9 docs) by delegating to the two register modules.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerApiTools } from './register-api-tools.js';
+import { registerDocsTools, loadData } from './register-docs-tools.js';
+import { createAnalytics } from './analytics.js';
+import { VERSION } from './version.js';
+/**
+ * Create a unified MCP server with all OneSource tools.
+ */
+export function createMcpServer(opts) {
+    const analytics = opts?.analytics ?? createAnalytics();
+    const transport = opts?.transport;
+    const server = new McpServer({
+        name: 'onesource',
+        version: VERSION,
+    });
+    const { client, count: apiCount } = registerApiTools({
+        server,
+        analytics,
+        transport,
+        client: opts?.client,
+    });
+    const docsCount = registerDocsTools({
+        server,
+        analytics,
+        transport,
+        data: opts?.docsData,
+    });
+    return { server, analytics, client, toolCount: apiCount + docsCount };
+}
+export { loadData };
+export { VERSION };
+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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAmB,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAoBvC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,eAAe,EAAE,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAElC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;QACnD,MAAM;QACN,SAAS;QACT,SAAS;QACT,MAAM,EAAE,IAAI,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,iBAAiB,CAAC;QAClC,MAAM;QACN,SAAS;QACT,SAAS;QACT,IAAI,EAAE,IAAI,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,SAAS,EAAE,CAAC;AACxE,CAAC;AAED,OAAO,EAAE,QAAQ,EAAmB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/register-api-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Register all 34 API tools from @one-source/api-mcp onto a shared McpServer.
+ *
+ * Replicates the exact instrumentation pattern from api-mcp's create-server.ts:
+ * per-call client context, x402 detection, performance timing, session hashing,
+ * and error sanitization.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type OneSourceClient } from '@one-source/api-mcp/client';
+import type { Analytics } from './analytics.js';
+export interface RegisterApiToolsOptions {
+    server: McpServer;
+    analytics: Analytics;
+    transport?: 'stdio' | 'http';
+    /** Override the default client (useful for sharing across HTTP requests). */
+    client?: OneSourceClient;
+}
+/**
+ * Register all API tools and return the client instance + tool count.
+ */
+export declare function registerApiTools(opts: RegisterApiToolsOptions): {
+    client: OneSourceClient;
+    count: number;
+};
+//# sourceMappingURL=register-api-tools.d.ts.map

package/dist/register-api-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-api-tools.d.ts","sourceRoot":"","sources":["../src/register-api-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQhD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,uBAAuB,GAC5B;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiH5C"}

package/dist/register-api-tools.js

@@ -0,0 +1,122 @@
+/**
+ * Register all 34 API tools from @one-source/api-mcp onto a shared McpServer.
+ *
+ * Replicates the exact instrumentation pattern from api-mcp's create-server.ts:
+ * per-call client context, x402 detection, performance timing, session hashing,
+ * and error sanitization.
+ */
+import { createHash } from 'node:crypto';
+import { allTools } from '@one-source/api-mcp/tools';
+import { createClientFromEnv } from '@one-source/api-mcp/client';
+import { VERSION } from './version.js';
+function hashSession(sessionId) {
+    if (!sessionId)
+        return undefined;
+    return createHash('sha256').update(sessionId).digest('hex').slice(0, 16);
+}
+/**
+ * Register all API tools and return the client instance + tool count.
+ */
+export function registerApiTools(opts) {
+    const { server, analytics, transport } = opts;
+    const client = opts.client ?? createClientFromEnv();
+    // Wire HTTP-level analytics from base 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(),
+        });
+    };
+    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();
+            // 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 { client, count: allTools.length };
+}
+//# sourceMappingURL=register-api-tools.js.map

package/dist/register-api-tools.js.map

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

package/dist/register-docs-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Register all 9 docs tools from @one-source/docs-mcp onto a shared McpServer.
+ *
+ * Replicates the exact instrumentation pattern from docs-mcp's create-server.ts:
+ * performance timing, session hashing, and error sanitization.
+ * Analytics events use service: 'onesource-docs', category: 'docs'.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { loadData, type LoadedData } from '@one-source/docs-mcp';
+import type { Analytics } from './analytics.js';
+export interface RegisterDocsToolsOptions {
+    server: McpServer;
+    analytics: Analytics;
+    transport?: 'stdio' | 'http';
+    /** Pre-loaded docs data (avoids re-reading files per request in HTTP mode). */
+    data?: LoadedData;
+}
+/**
+ * Register all docs tools and return the tool count.
+ */
+export declare function registerDocsTools(opts: RegisterDocsToolsOptions): number;
+export { loadData, type LoadedData };
+//# sourceMappingURL=register-docs-tools.d.ts.map

package/dist/register-docs-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-docs-tools.d.ts","sourceRoot":"","sources":["../src/register-docs-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWjE,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AA+E/D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAoExE;AAED,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,CAAC"}

package/dist/register-docs-tools.js

@@ -0,0 +1,102 @@
+/**
+ * Register all 9 docs tools from @one-source/docs-mcp onto a shared McpServer.
+ *
+ * Replicates the exact instrumentation pattern from docs-mcp's create-server.ts:
+ * performance timing, session hashing, and error sanitization.
+ * Analytics events use service: 'onesource-docs', category: 'docs'.
+ */
+import { createHash } from 'node:crypto';
+import { loadData } from '@one-source/docs-mcp';
+import { searchDocsSchema, handleSearchDocs } from '@one-source/docs-mcp/tools/search-docs';
+import { getQueryReferenceSchema, handleGetQueryReference } from '@one-source/docs-mcp/tools/get-query-reference';
+import { getTypeDefinitionSchema, handleGetTypeDefinition } from '@one-source/docs-mcp/tools/get-type-definition';
+import { listExamplesSchema, handleListExamples } from '@one-source/docs-mcp/tools/list-examples';
+import { listSupportedChainsSchema, handleListSupportedChains } from '@one-source/docs-mcp/tools/list-supported-chains';
+import { getFilterReferenceSchema, handleGetFilterReference } from '@one-source/docs-mcp/tools/get-filter-reference';
+import { getPaginationGuideSchema, handleGetPaginationGuide } from '@one-source/docs-mcp/tools/get-pagination-guide';
+import { getSchemaOverviewSchema, handleGetSchemaOverview } from '@one-source/docs-mcp/tools/get-schema-overview';
+import { getAuthenticationGuideSchema, handleGetAuthenticationGuide } from '@one-source/docs-mcp/tools/get-authentication-guide';
+import { VERSION } from './version.js';
+function hashSession(sessionId) {
+    if (!sessionId)
+        return undefined;
+    return createHash('sha256').update(sessionId).digest('hex').slice(0, 16);
+}
+/**
+ * Register an instrumented docs tool — wraps the handler with analytics tracking.
+ *
+ * Uses `any` for the handler input type because the MCP SDK's overloaded
+ * `server.tool()` signature makes generics impractical here. Each handler
+ * is still type-safe at its own definition site.
+ */
+function instrumentedTool(server, analytics, transport, name, description, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+handler) {
+    server.tool(name, description, schema, async (input, extra) => {
+        const start = performance.now();
+        const inputKeys = Object.keys(input);
+        const sessionHash = hashSession(extra.sessionId);
+        const clientInfo = server.server.getClientVersion();
+        const base = {
+            type: 'tool_call',
+            service: 'onesource-docs',
+            tool: name,
+            category: 'docs',
+            timestamp: new Date().toISOString(),
+            input_params: inputKeys,
+            version: VERSION,
+            auth_method: 'none',
+            client_name: clientInfo?.name,
+            client_version: clientInfo?.version,
+            session_id: sessionHash,
+            transport,
+        };
+        try {
+            const text = handler(input);
+            const durationMs = Math.round(performance.now() - start);
+            analytics.trackTool({
+                ...base,
+                duration_ms: durationMs,
+                success: true,
+                response_size: text.length,
+            });
+            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({
+                ...base,
+                duration_ms: durationMs,
+                success: false,
+                error_category: message.slice(0, 100).replace(/0x[a-fA-F0-9]+/g, '0x***'),
+                response_size: 0,
+            });
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Tool error: ${message.slice(0, 500).replace(/0x[a-fA-F0-9]+/g, '0x***')}` }],
+            };
+        }
+    });
+}
+/**
+ * Register all docs tools and return the tool count.
+ */
+export function registerDocsTools(opts) {
+    const { server, analytics, transport } = opts;
+    const { sections, index, schema } = opts.data ?? loadData();
+    instrumentedTool(server, analytics, transport, 'search_docs', 'Search OneSource documentation by keyword. Returns the top 5 matching sections.', searchDocsSchema.shape, (input) => handleSearchDocs(input, index));
+    instrumentedTool(server, analytics, transport, 'get_query_reference', 'Get full reference for a OneSource root GraphQL query — arguments, filters, return type. There are 12 root queries: address, addresses, block, blocks, contract, contracts, nft, nfts, token, tokens, transaction, transactions.', getQueryReferenceSchema.shape, (input) => handleGetQueryReference(input, schema));
+    instrumentedTool(server, analytics, transport, 'get_type_definition', 'Get the schema definition for a GraphQL type, enum, scalar, input, or interface. Returns fields, values, and descriptions.', getTypeDefinitionSchema.shape, (input) => handleGetTypeDefinition(input, schema));
+    instrumentedTool(server, analytics, transport, 'list_examples', 'List or search working GraphQL examples. Without a topic, returns a summary of all available examples. With a topic, returns full example content matching that keyword.', listExamplesSchema.shape, (input) => handleListExamples(input, sections));
+    instrumentedTool(server, analytics, transport, 'list_supported_chains', 'List all blockchain networks supported by OneSource with endpoint URLs.', listSupportedChainsSchema.shape, () => handleListSupportedChains());
+    instrumentedTool(server, analytics, transport, 'get_filter_reference', 'Get all filter fields and operators for a list query (e.g. transactions, tokens).', getFilterReferenceSchema.shape, (input) => handleGetFilterReference(input, schema));
+    instrumentedTool(server, analytics, transport, 'get_pagination_guide', 'Get the cursor-based pagination pattern with examples for a list query.', getPaginationGuideSchema.shape, (input) => handleGetPaginationGuide(input, schema));
+    instrumentedTool(server, analytics, transport, 'get_schema_overview', 'Get a high-level summary of the entire GraphQL schema — all queries, types, enums, and scalars.', getSchemaOverviewSchema.shape, () => handleGetSchemaOverview(schema));
+    instrumentedTool(server, analytics, transport, 'get_authentication_guide', 'Get the authentication guide — API key format, endpoints, headers, and common mistakes.', getAuthenticationGuideSchema.shape, () => handleGetAuthenticationGuide());
+    return 9;
+}
+export { loadData };
+//# sourceMappingURL=register-docs-tools.js.map

package/dist/register-docs-tools.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,EAAE,MAA2C,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export const VERSION = require('../package.json').version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@one-source/mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Unified MCP server for OneSource — 43 tools for blockchain data and API documentation",
+  "bin": {
+    "onesource-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/create-server.js",
+  "types": "./dist/create-server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/create-server.d.ts",
+      "default": "./dist/create-server.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@one-source/api-mcp": "^1.1.0",
+    "@one-source/docs-mcp": "^2.3.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "onesource",
+    "web3",
+    "blockchain",
+    "graphql",
+    "documentation",
+    "x402"
+  ],
+  "author": "BlockParty",
+  "license": "UNLICENSED",
+  "homepage": "https://docs.onesource.io"
+}