@entroute/mcp-server 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * EntRoute MCP Server
+ *
+ * Model Context Protocol server for agent integration.
+ * Provides tools for discovering and calling pay-per-request APIs.
+ *
+ * Tools:
+ * - discover_paid_api: Find endpoints for a capability
+ * - list_capabilities: Browse available capability types
+ * - call_paid_api: Execute a discovered endpoint (with x402 v2 payment handling)
+ *
+ * Environment variables:
+ * - ENTROUTE_API_URL: API base URL (default: http://localhost:8787)
+ * - EVM_PRIVATE_KEY: Hex private key (0x...) for automatic x402 payments
+ * - MAX_PAYMENT_PER_REQUEST: Max USD per request (default: 0.05)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,451 @@
+#!/usr/bin/env node
+/**
+ * EntRoute MCP Server
+ *
+ * Model Context Protocol server for agent integration.
+ * Provides tools for discovering and calling pay-per-request APIs.
+ *
+ * Tools:
+ * - discover_paid_api: Find endpoints for a capability
+ * - list_capabilities: Browse available capability types
+ * - call_paid_api: Execute a discovered endpoint (with x402 v2 payment handling)
+ *
+ * Environment variables:
+ * - ENTROUTE_API_URL: API base URL (default: http://localhost:8787)
+ * - EVM_PRIVATE_KEY: Hex private key (0x...) for automatic x402 payments
+ * - MAX_PAYMENT_PER_REQUEST: Max USD per request (default: 0.05)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { EntRouteClient, PaymentRequiredError, PaymentExceedsLimitError, } from '@entroute/sdk-agent-ts';
+// Payment configuration from environment
+const evmPrivateKey = process.env.EVM_PRIVATE_KEY;
+const maxPaymentPerRequest = process.env.MAX_PAYMENT_PER_REQUEST
+    ? parseFloat(process.env.MAX_PAYMENT_PER_REQUEST)
+    : 0.05;
+const paymentConfigured = !!evmPrivateKey;
+// Initialize client with optional payment support
+const client = new EntRouteClient({
+    baseUrl: process.env.ENTROUTE_API_URL || 'http://localhost:8787',
+    clientId: 'mcp-server',
+    autoReportOutcomes: true,
+    evmPrivateKey: evmPrivateKey,
+    maxPaymentPerRequest,
+});
+if (paymentConfigured) {
+    console.error(`Payment enabled: wallet ${client.walletAddress}, max $${maxPaymentPerRequest}/request`);
+}
+else {
+    console.error('Payment not configured. Set EVM_PRIVATE_KEY to enable automatic x402 payments.');
+}
+// Store discovered endpoints for call_paid_api
+const endpointCache = new Map();
+const server = new Server({
+    name: 'entroute',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Build dynamic tool description for call_paid_api based on payment config
+const callApiDescription = paymentConfigured
+    ? `Call a previously discovered API endpoint.
+
+Use this after discover_paid_api to execute the request.
+Automatically handles x402 payments up to $${maxPaymentPerRequest.toFixed(2)} per request using the configured wallet.
+
+IMPORTANT: You must first use discover_paid_api to find an endpoint.
+Then use the endpoint_id from the discovery result.`
+    : `Call a previously discovered API endpoint.
+
+Use this after discover_paid_api to execute the request.
+Payment-required endpoints (402) will return an error with payment details since no wallet is configured.
+
+IMPORTANT: You must first use discover_paid_api to find an endpoint.
+Then use the endpoint_id from the discovery result.`;
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'discover_paid_api',
+                description: `Discover pay-per-request API endpoints for a given capability.
+
+Returns ranked, verified endpoints with pricing and reliability metrics.
+Use this to find APIs before calling them. The results include:
+- Endpoint URL and method
+- Price per call and payment network
+- Success rate and latency metrics
+- Provider information
+
+After discovering, you can use call_paid_api to execute the endpoint.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        intent: {
+                            type: 'string',
+                            description: 'Natural language description of what you want to do (e.g., "get current weather for London", "translate text to Spanish")',
+                        },
+                        capability_id: {
+                            type: 'string',
+                            description: 'Explicit capability ID if known (e.g., "weather.current", "translate.text"). Use this for precise matching.',
+                        },
+                        max_price: {
+                            type: 'number',
+                            description: 'Maximum price per request in USD (e.g., 0.01 for 1 cent)',
+                        },
+                        network: {
+                            type: 'string',
+                            description: 'Required blockchain network for payment',
+                            enum: ['base', 'ethereum', 'solana', 'polygon', 'arbitrum'],
+                        },
+                        ranking_preset: {
+                            type: 'string',
+                            description: 'Ranking preference preset',
+                            enum: ['default', 'reliability', 'speed', 'budget', 'balanced'],
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of endpoints to return (default: 5)',
+                        },
+                    },
+                    oneOf: [{ required: ['intent'] }, { required: ['capability_id'] }],
+                },
+            },
+            {
+                name: 'list_capabilities',
+                description: `List available API capability types.
+
+Use this to explore what kinds of APIs are available in the registry.
+You can filter by tag (e.g., "weather", "translation") or search by keyword.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag: {
+                            type: 'string',
+                            description: 'Filter by tag (e.g., "weather", "translation", "finance")',
+                        },
+                        search: {
+                            type: 'string',
+                            description: 'Search capabilities by keyword',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'call_paid_api',
+                description: callApiDescription,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        endpoint_id: {
+                            type: 'string',
+                            description: 'The endpoint_id from a previous discover_paid_api result',
+                        },
+                        method: {
+                            type: 'string',
+                            description: 'HTTP method (defaults to endpoint method)',
+                            enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'],
+                        },
+                        headers: {
+                            type: 'object',
+                            description: 'Additional headers to include in the request',
+                            additionalProperties: { type: 'string' },
+                        },
+                        body: {
+                            type: 'object',
+                            description: 'Request body (for POST/PUT/PATCH)',
+                            additionalProperties: true,
+                        },
+                        query_params: {
+                            type: 'object',
+                            description: 'Query parameters to append to URL',
+                            additionalProperties: { type: 'string' },
+                        },
+                    },
+                    required: ['endpoint_id'],
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case 'discover_paid_api':
+            return handleDiscover(args);
+        case 'list_capabilities':
+            return handleListCapabilities(args);
+        case 'call_paid_api':
+            return handleCallApi(args);
+        default:
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+                isError: true,
+            };
+    }
+});
+async function handleDiscover(args) {
+    try {
+        const result = args.intent
+            ? await client.discoverByIntent(args.intent, {
+                constraints: {
+                    max_price: args.max_price,
+                    network: args.network,
+                },
+                preferences: {
+                    ranking_preset: args.ranking_preset,
+                    limit: args.limit,
+                    include_fallbacks: true,
+                },
+            })
+            : await client.discoverByCapability(args.capability_id, undefined, {
+                constraints: {
+                    max_price: args.max_price,
+                    network: args.network,
+                },
+                preferences: {
+                    ranking_preset: args.ranking_preset,
+                    limit: args.limit,
+                    include_fallbacks: true,
+                },
+            });
+        // Cache endpoints for later use with call_paid_api
+        for (const ep of result.ranked_endpoints) {
+            endpointCache.set(ep.endpoint_id, ep);
+        }
+        if (result.fallback_endpoints) {
+            for (const ep of result.fallback_endpoints) {
+                endpointCache.set(ep.endpoint_id, ep);
+            }
+        }
+        // Format response for the model
+        const endpoints = result.ranked_endpoints.map((ep) => formatEndpoint(ep));
+        const fallbacks = result.fallback_endpoints?.map((ep) => ({
+            ...formatEndpoint(ep),
+            exclusion_reasons: ep.exclusion_reasons,
+        }));
+        const response = {
+            capability: result.resolved.capability_id,
+            confidence: result.resolved.confidence,
+            candidates: result.resolved.candidates,
+            endpoints,
+            fallbacks: fallbacks?.length ? fallbacks : undefined,
+            ranking: result.ranking_info,
+            ttl_seconds: result.ttl_seconds,
+            payment_enabled: paymentConfigured,
+            usage_hint: endpoints.length > 0
+                ? `Use call_paid_api with endpoint_id "${endpoints[0].endpoint_id}" to call the top result.`
+                : 'No endpoints found. Try broadening your search or using a fallback.',
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Discovery failed';
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+async function handleListCapabilities(args) {
+    try {
+        const result = await client.listCapabilities({
+            tag: args.tag,
+            search: args.search,
+        });
+        const capabilities = result.capabilities.map((cap) => ({
+            id: cap.id,
+            title: cap.title,
+            description: cap.description,
+            tags: cap.tags,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        version: result.version,
+                        count: capabilities.length,
+                        capabilities,
+                        usage_hint: 'Use discover_paid_api with a capability_id to find endpoints.',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to list capabilities';
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+async function handleCallApi(args) {
+    const endpoint = endpointCache.get(args.endpoint_id);
+    if (!endpoint) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Endpoint not found in cache. Use discover_paid_api first to find endpoints.',
+                        hint: 'The endpoint_id must come from a recent discover_paid_api result.',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        // Build query params into body for GET requests if needed
+        let requestBody = args.body;
+        if (args.query_params && Object.keys(args.query_params).length > 0) {
+            if (endpoint.method === 'GET' || args.method === 'GET') {
+                // For GET, merge query_params into body so buildRequestUrl handles them
+                requestBody = { ...requestBody, ...args.query_params };
+            }
+        }
+        // Use SDK's callEndpoint which handles x402 v2 payments automatically
+        const result = await client.callEndpoint(endpoint, {
+            buildRequest: (ep) => {
+                let url = ep.url;
+                // Append query params for non-GET methods
+                if (args.query_params && Object.keys(args.query_params).length > 0 && ep.method !== 'GET') {
+                    const params = new URLSearchParams(args.query_params);
+                    url += (url.includes('?') ? '&' : '?') + params.toString();
+                }
+                return {
+                    method: args.method || ep.method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Accept': 'application/json',
+                        ...args.headers,
+                    },
+                    body: args.body ? JSON.stringify(args.body) : undefined,
+                };
+            },
+            body: requestBody,
+            timeout: 30000,
+            autoPay: paymentConfigured,
+        });
+        const response = {
+            status: result.status,
+            data: result.data,
+            latency_ms: result.latencyMs,
+            endpoint: {
+                url: endpoint.url,
+                provider: endpoint.provider_name,
+            },
+        };
+        // Include payment receipt if payment was made
+        if (result.payment) {
+            response.payment = {
+                amount: result.payment.amount,
+                asset: result.payment.asset,
+                network: result.payment.network,
+                recipient: result.payment.recipient,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // Handle payment-specific errors with helpful messages
+        if (error instanceof PaymentRequiredError) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 402,
+                            message: 'Payment required but no wallet configured',
+                            payment_info: {
+                                payTo: error.paymentChallenge.payTo,
+                                amount: error.paymentChallenge.maxAmountRequired,
+                                network: error.paymentChallenge.network,
+                                asset: error.paymentChallenge.asset,
+                                endpoint_price: endpoint.payment.price_per_call,
+                            },
+                            hint: 'Set EVM_PRIVATE_KEY environment variable to enable automatic payments.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (error instanceof PaymentExceedsLimitError) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 402,
+                            message: `Payment of $${error.requestedAmount.toFixed(4)} exceeds limit of $${error.maxAllowed.toFixed(2)}`,
+                            hint: 'Increase MAX_PAYMENT_PER_REQUEST or choose a cheaper endpoint.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const message = error instanceof Error ? error.message : 'API call failed';
+        // Report failure
+        client.reportOutcome({
+            endpoint_id: endpoint.endpoint_id,
+            success: false,
+            error_code: 'call_failed',
+        }).catch(() => { });
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+function formatEndpoint(ep) {
+    return {
+        endpoint_id: ep.endpoint_id,
+        url: ep.url,
+        method: ep.method,
+        provider: ep.provider_name,
+        price: `$${ep.payment.price_per_call}`,
+        payment: {
+            assets: ep.payment.accepted_assets,
+            network: ep.payment.network,
+        },
+        metrics: {
+            success_rate: ep.observed.success_rate_7d
+                ? `${(ep.observed.success_rate_7d * 100).toFixed(1)}%`
+                : 'unknown',
+            latency: ep.observed.p95_latency_ms
+                ? `${ep.observed.p95_latency_ms}ms p95`
+                : 'unknown',
+            last_verified: ep.observed.last_verified_at || 'never',
+        },
+        score: ep.score?.toFixed(3),
+    };
+}
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('EntRoute MCP server running on stdio');
+    console.error(`API URL: ${process.env.ENTROUTE_API_URL || 'http://localhost:8787'}`);
+}
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(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":";AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,wBAAwB,CAAC;AAEhC,yCAAyC;AACzC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAClD,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB;IAC9D,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACjD,CAAC,CAAC,IAAI,CAAC;AACT,MAAM,iBAAiB,GAAG,CAAC,CAAC,aAAa,CAAC;AAE1C,kDAAkD;AAClD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB;IAChE,QAAQ,EAAE,YAAY;IACtB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,aAAa;IAC5B,oBAAoB;CACrB,CAAC,CAAC;AAEH,IAAI,iBAAiB,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,aAAa,UAAU,oBAAoB,UAAU,CAAC,CAAC;AACzG,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,gFAAgF,CAAC,CAAC;AAClG,CAAC;AAED,+CAA+C;AAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,EAA0B,CAAC;AAExD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG,iBAAiB;IAC1C,CAAC,CAAC;;;6CAGyC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;;;oDAGxB;IAClD,CAAC,CAAC;;;;;;oDAMgD,CAAC;AAErD,uBAAuB;AACvB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE;;;;;;;;;sEASiD;gBAC9D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2HAA2H;yBACzI;wBACD,aAAa,EAAE;4BACb,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6GAA6G;yBAC3H;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0DAA0D;yBACxE;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,yCAAyC;4BACtD,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;yBAC5D;wBACD,cAAc,EAAE;4BACd,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2BAA2B;4BACxC,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;yBAChE;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,oDAAoD;yBAClE;qBACF;oBACD,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;iBACnE;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE;;;6EAGwD;gBACrE,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,GAAG,EAAE;4BACH,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2DAA2D;yBACzE;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gCAAgC;yBAC9C;qBACF;iBACF;aACF;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,kBAAkB;gBAC/B,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0DAA0D;yBACxE;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2CAA2C;4BACxD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;yBAChD;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,8CAA8C;4BAC3D,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBACzC;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,mCAAmC;4BAChD,oBAAoB,EAAE,IAAI;yBAC3B;wBACD,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,mCAAmC;4BAChD,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBACzC;qBACF;oBACD,QAAQ,EAAE,CAAC,aAAa,CAAC;iBAC1B;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,oBAAoB;AACpB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,mBAAmB;YACtB,OAAO,cAAc,CAAC,IAOrB,CAAC,CAAC;QAEL,KAAK,mBAAmB;YACtB,OAAO,sBAAsB,CAAC,IAG7B,CAAC,CAAC;QAEL,KAAK,eAAe;YAClB,OAAO,aAAa,CAAC,IAMpB,CAAC,CAAC;QAEL;YACE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;gBACrF,OAAO,EAAE,IAAI;aACd,CAAC;IACN,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,cAAc,CAAC,IAO7B;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;YACxB,CAAC,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE;gBACzC,WAAW,EAAE;oBACX,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAkE;iBACjF;gBACD,WAAW,EAAE;oBACX,cAAc,EAAE,IAAI,CAAC,cAA6E;oBAClG,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC;YACJ,CAAC,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAc,EAAE,SAAS,EAAE;gBAChE,WAAW,EAAE;oBACX,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAkE;iBACjF;gBACD,WAAW,EAAE;oBACX,cAAc,EAAE,IAAI,CAAC,cAA6E;oBAClG,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;QAEP,mDAAmD;QACnD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACzC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC3C,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACxD,GAAG,cAAc,CAAC,EAAE,CAAC;YACrB,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;SACxC,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;YACzC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,SAAS;YACT,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACpD,OAAO,EAAE,MAAM,CAAC,YAAY;YAC5B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,iBAAiB;YAClC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;gBAC9B,CAAC,CAAC,uCAAuC,SAAS,CAAC,CAAC,CAAE,CAAC,WAAW,2BAA2B;gBAC7F,CAAC,CAAC,qEAAqE;SAC1E,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,IAAuC;IAC3E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;YAC3C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrD,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,KAAK,EAAE,YAAY,CAAC,MAAM;wBAC1B,YAAY;wBACZ,UAAU,EAAE,+DAA+D;qBAC5E,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;QACvF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAM5B;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,6EAA6E;wBACpF,IAAI,EAAE,mEAAmE;qBAC1E,CAAC;iBACH;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,0DAA0D;QAC1D,IAAI,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACvD,wEAAwE;gBACxE,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;YACjD,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE;gBACnB,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC;gBACjB,0CAA0C;gBAC1C,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;oBAC1F,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBACtD,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC7D,CAAC;gBAED,OAAO;oBACL,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,MAAM;oBAChC,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,QAAQ,EAAE,kBAAkB;wBAC5B,GAAG,IAAI,CAAC,OAAO;qBAChB;oBACD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;iBACxD,CAAC;YACJ,CAAC;YACD,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,iBAAiB;SAC3B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAA4B;YACxC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,QAAQ,EAAE;gBACR,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,QAAQ,EAAE,QAAQ,CAAC,aAAa;aACjC;SACF,CAAC;QAEF,8CAA8C;QAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,CAAC,OAAO,GAAG;gBACjB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;gBAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;aACpC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uDAAuD;QACvD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,GAAG;4BACX,OAAO,EAAE,2CAA2C;4BACpD,YAAY,EAAE;gCACZ,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,KAAK;gCACnC,MAAM,EAAE,KAAK,CAAC,gBAAgB,CAAC,iBAAiB;gCAChD,OAAO,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO;gCACvC,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,KAAK;gCACnC,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;6BAChD;4BACD,IAAI,EAAE,wEAAwE;yBAC/E,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,GAAG;4BACX,OAAO,EAAE,eAAe,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;4BAC3G,IAAI,EAAE,gEAAgE;yBACvE,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAE3E,iBAAiB;QACjB,MAAM,CAAC,aAAa,CAAC;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,aAAa;SAC1B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEnB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,EAAkB;IACxC,OAAO;QACL,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,QAAQ,EAAE,EAAE,CAAC,aAAa;QAC1B,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE;QACtC,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe;YAClC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO;SAC5B;QACD,OAAO,EAAE;YACP,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe;gBACvC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;gBACtD,CAAC,CAAC,SAAS;YACb,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc;gBACjC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,QAAQ;gBACvC,CAAC,CAAC,SAAS;YACb,aAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO;SACvD;QACD,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@entroute/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP Server for AI agents to discover and call pay-per-request APIs via EntRoute",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "entroute-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "entroute",
+    "mcp",
+    "x402",
+    "api-discovery",
+    "pay-per-request",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/entroute/entroute",
+    "directory": "apps/mcp-server"
+  },
+  "homepage": "https://entroute.com",
+  "dependencies": {
+    "@entroute/sdk-agent-ts": "^0.2.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "viem": "^2.44.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}