crossfin-mcp 1.7.1 → 1.8.2

package/README.md

@@ -1,6 +1,6 @@
 # CrossFin MCP Server
 
-MCP server for CrossFin — 13 tools for service discovery, local ledger, and paid API execution.
+MCP server for CrossFin — 16 tools for service discovery, local ledger, routing engine, and paid API execution.
 
 ## Install (npm)
 
@@ -37,6 +37,12 @@ crossfin-mcp
 - `get_analytics`
 - `get_guide`
 
+### Routing engine
+
+- `find_optimal_route` — find optimal crypto transfer route across 6 exchanges (paid via x402, requires `EVM_PRIVATE_KEY`)
+- `list_exchange_fees` — compare trading and withdrawal fees across exchanges
+- `compare_exchange_prices` — compare live prices for a coin across Korean exchanges
+
 ### Paid execution
 
 - `call_paid_service` — call any CrossFin paid endpoint with automatic x402 USDC payment on Base (requires `EVM_PRIVATE_KEY`)

package/dist/index.js

@@ -5,11 +5,15 @@ import { z } from 'zod/v4';
 import { x402Client, wrapFetchWithPayment, x402HTTPClient } from '@x402/fetch';
 import { registerExactEvmScheme } from '@x402/evm/exact/client';
 import { privateKeyToAccount } from 'viem/accounts';
+import { createRequire } from 'node:module';
 import { createWallet, defaultLedgerPath, getBalance, listTransactions, setBudget, transfer, } from './ledgerStore.js';
 const LEDGER_PATH = process.env.CROSSFIN_LEDGER_PATH?.trim() || defaultLedgerPath();
 const API_BASE = (process.env.CROSSFIN_API_URL?.trim() || 'https://crossfin.dev').replace(/\/$/, '');
 const EVM_PRIVATE_KEY = process.env.EVM_PRIVATE_KEY?.trim() ?? '';
 const API_ORIGIN = new URL(API_BASE).origin;
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const MCP_VERSION = typeof pkg.version === 'string' && pkg.version.trim() ? pkg.version.trim() : '0.0.0';
 function ensureCrossfinPaidUrl(raw) {
     let url;
     try {
@@ -53,7 +57,7 @@ function basescanLink(networkId, txHash) {
         return `https://basescan.org/tx/${txHash}`;
     return null;
 }
-const server = new McpServer({ name: 'crossfin', version: '1.7.1' });
+const server = new McpServer({ name: 'crossfin', version: MCP_VERSION });
 const railSchema = z.enum(['manual', 'kakaopay', 'toss', 'stripe', 'x402']);
 async function apiFetch(path) {
     const res = await fetch(`${API_BASE}${path}`);
@@ -394,5 +398,114 @@ server.registerTool('call_paid_service', {
         };
     }
 });
+/* ── Routing Engine Tools ── */
+server.registerTool('find_optimal_route', {
+    title: 'Find optimal route',
+    description: 'Find the cheapest/fastest path to move money across Asian exchanges. ' +
+        'Example: KRW on Bithumb → USDC on Binance. ' +
+        'Supports 6 exchanges (Bithumb, Upbit, Coinone, Korbit, GoPax, Binance) and 12 bridge coins. ' +
+        'Paid tool: calls /api/premium/route/find ($0.10) via x402 (requires EVM_PRIVATE_KEY).',
+    inputSchema: z.object({
+        from: z
+            .string()
+            .describe('Source in exchange:currency format (e.g. "bithumb:KRW", "upbit:KRW")'),
+        to: z
+            .string()
+            .describe('Destination in exchange:currency format (e.g. "binance:USDC", "binance:BTC")'),
+        amount: z.number().describe('Amount in source currency (e.g. 1000000 for ₩1,000,000)'),
+        strategy: z
+            .enum(['cheapest', 'fastest', 'balanced'])
+            .optional()
+            .describe('Routing strategy: cheapest (default), fastest, or balanced'),
+    }),
+}, async ({ from, to, amount, strategy }) => {
+    if (!paidFetch || !httpClient) {
+        return {
+            content: [{ type: 'text', text: 'EVM_PRIVATE_KEY not configured — cannot call paid routing endpoint' }],
+            isError: true,
+        };
+    }
+    try {
+        const qs = new URLSearchParams({
+            from,
+            to,
+            amount: String(amount),
+        });
+        if (strategy)
+            qs.set('strategy', strategy);
+        const targetUrl = ensureCrossfinPaidUrl(`${API_BASE}/api/premium/route/find?${qs.toString()}`);
+        const res = await paidFetch(targetUrl, { method: 'GET' });
+        const body = await res.text();
+        let data;
+        try {
+            data = JSON.parse(body);
+        }
+        catch {
+            data = body;
+        }
+        const settle = httpClient.getPaymentSettleResponse((name) => res.headers.get(name));
+        const txHash = settle?.transaction;
+        const networkId = settle?.network;
+        const scanLink = basescanLink(networkId, txHash);
+        const result = {
+            status: res.status,
+            payer: payerAddress,
+            paid: !!settle,
+            txHash: txHash ?? null,
+            basescan: scanLink,
+            data,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : 'Unknown error'}` }],
+            isError: true,
+        };
+    }
+});
+server.registerTool('list_exchange_fees', {
+    title: 'List exchange fees',
+    description: 'Show trading fees, withdrawal fees, and transfer times for all supported exchanges ' +
+        '(Bithumb, Upbit, Coinone, Korbit, GoPax, Binance)',
+    inputSchema: z.object({}),
+}, async (_params) => {
+    try {
+        const data = await apiFetch('/api/route/fees');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : 'Unknown error'}` }],
+            isError: true,
+        };
+    }
+});
+server.registerTool('compare_exchange_prices', {
+    title: 'Compare exchange prices',
+    description: 'Compare real-time prices for a coin across all Korean exchanges + Binance. ' +
+        'Shows price, premium, and arbitrage opportunities.',
+    inputSchema: z.object({
+        coin: z
+            .string()
+            .optional()
+            .describe('Coin symbol to compare (e.g. "BTC", "XRP"). Omit for all supported coins.'),
+    }),
+}, async ({ coin }) => {
+    try {
+        const qs = new URLSearchParams();
+        if (coin?.trim())
+            qs.set('coin', coin.trim().toUpperCase());
+        const path = qs.size ? `/api/route/pairs?${qs.toString()}` : '/api/route/pairs';
+        const data = await apiFetch(path);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : 'Unknown error'}` }],
+            isError: true,
+        };
+    }
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "crossfin-mcp",
   "private": false,
-  "version": "1.7.1",
+  "version": "1.8.2",
   "description": "CrossFin MCP server for service discovery and paid x402 API execution",
   "bin": {
     "crossfin-mcp": "dist/index.js"