@x402-api/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,242 @@
+# @x402-api/mcp-server
+
+> MCP server that gives Claude, ChatGPT, and any MCP-compatible AI agent access to pay-per-call crypto/DeFi data via the [x402 protocol](https://github.com/coinbase/x402).
+
+**8 tools. No API keys. AI agents pay USDC micropayments on Base, per request.**
+
+```
+  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
+   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
+    ╚███╔╝ ███████║██║   ██║ █████╔╝
+    ██╔██╗ ╚════██║██║   ██║██╔═══╝
+   ██╔╝ ██╗     ██║╚██████╔╝███████╗
+   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝
+```
+
+## Tools
+
+| Tool | API Endpoint | Cost | Description |
+|------|-------------|------|-------------|
+| `get_crypto_prices` | `GET /api/price-feed` | 0.001 USDC | BTC/ETH/SOL + top 24h movers |
+| `get_gas_prices` | `GET /api/gas-tracker` | 0.001 USDC | Multi-chain gas (ETH, Base, Polygon, Arbitrum) |
+| `get_dex_quotes` | `GET /api/dex-quotes` | 0.002 USDC | Swap quotes: Uniswap, SushiSwap, 1inch |
+| `scan_token` | `GET /api/token-scanner` | 0.003 USDC | Token security scan + rug-pull detection |
+| `track_whales` | `GET /api/whale-tracker` | 0.005 USDC | Holder concentration + whale alerts |
+| `scan_yields` | `GET /api/yield-scanner` | 0.005 USDC | DeFi yields: Aave, Compound, Morpho, Lido, Pendle |
+| `get_funding_rates` | `GET /api/funding-rates` | 0.008 USDC | Perp funding rates across 6 venues |
+| `profile_wallet` | `GET /api/wallet-profiler` | 0.008 USDC | Full wallet portfolio + risk profile |
+
+---
+
+## Quick Start
+
+### Option A: Inspect mode (no payment needed)
+
+Just run it — any 402 responses will return human-readable payment instructions:
+
+```bash
+npx @x402-api/mcp-server
+```
+
+Claude will tell you what's needed when a tool requires payment.
+
+### Option B: Auto-pay mode (fully autonomous)
+
+Install optional payment deps and set your wallet key:
+
+```bash
+npm install -g @x402-api/mcp-server
+npm install -g x402-fetch viem
+export X402_WALLET_PRIVATE_KEY=0x<your_private_key>
+x402-api-mcp
+```
+
+The server will auto-pay 402 responses using USDC on Base. **Make sure your wallet has USDC on Base mainnet.**
+
+---
+
+## Claude Desktop Integration
+
+Add to your `claude_desktop_config.json`:
+
+### Without auto-pay (inspect mode)
+
+```json
+{
+  "mcpServers": {
+    "x402-api": {
+      "command": "npx",
+      "args": ["@x402-api/mcp-server"]
+    }
+  }
+}
+```
+
+### With auto-pay
+
+```json
+{
+  "mcpServers": {
+    "x402-api": {
+      "command": "npx",
+      "args": ["@x402-api/mcp-server"],
+      "env": {
+        "X402_WALLET_PRIVATE_KEY": "0x<your_private_key>"
+      }
+    }
+  }
+}
+```
+
+**Config file location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `X402_WALLET_PRIVATE_KEY` | Optional | Private key for auto-pay (e.g. `0x...`). If set, x402-fetch handles payments automatically. |
+| `X402_API_BASE_URL` | Optional | Override API URL (default: `https://x402-api.fly.dev`) |
+
+---
+
+## How x402 Payments Work
+
+This API uses the [x402 protocol](https://github.com/coinbase/x402) — HTTP 402 Payment Required:
+
+1. **Agent calls tool** → MCP server makes API request
+2. **Server returns 402** with payment details (amount, USDC address, Base network)
+3. **Auto-pay mode:** x402-fetch signs and submits payment, retries request automatically
+4. **Manual mode:** MCP returns 402 details so user/agent can arrange payment
+
+**Payment details:**
+- Token: USDC on Base mainnet
+- Address: `0x60264c480b67adb557efEd22Cf0e7ceA792DefB7`
+- Chain: Base (chain ID 8453)
+- Amount: 0.001–0.008 USDC per call (< 1 cent USD)
+
+---
+
+## Tool Reference
+
+### `get_crypto_prices`
+No parameters. Returns current prices for BTC, ETH, SOL + top 24h movers.
+
+```
+Cost: 0.001 USDC
+```
+
+### `get_gas_prices`
+No parameters. Returns gas prices for Ethereum, Base, Polygon, Arbitrum — slow/standard/fast tiers.
+
+```
+Cost: 0.001 USDC
+```
+
+### `get_dex_quotes`
+Compare swap quotes across DEXes.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `from` | string | ✅ | Input token (e.g. `"ETH"`, `"0x..."`) |
+| `to` | string | ✅ | Output token (e.g. `"USDC"`) |
+| `amount` | string | ✅ | Amount to swap (e.g. `"1.5"`) |
+
+```
+Cost: 0.002 USDC
+```
+
+### `scan_token`
+Token security scan — detects rug-pull flags, honeypot patterns, mint authority, etc.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `token` | string | ✅ | Contract address or symbol (e.g. `"PEPE"`) |
+
+```
+Cost: 0.003 USDC
+```
+
+### `track_whales`
+Whale tracking — holder concentration, Gini coefficient, recent large moves.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `token` | string | ✅ | Contract address or symbol |
+
+```
+Cost: 0.005 USDC
+```
+
+### `scan_yields`
+Top DeFi yield opportunities across Aave, Compound, Morpho, Lido, Pendle, etc.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `chain` | string | ❌ | Filter by chain: `"ethereum"`, `"base"`, `"arbitrum"`, `"polygon"` |
+| `min_tvl` | number | ❌ | Minimum TVL in USD (e.g. `1000000`) |
+
+```
+Cost: 0.005 USDC
+```
+
+### `get_funding_rates`
+Perpetual funding rates across Binance, OKX, Bybit, dYdX, GMX, Hyperliquid.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `asset` | string | ❌ | Asset symbol (e.g. `"BTC"`, `"ETH"`). All assets if omitted. |
+
+```
+Cost: 0.008 USDC
+```
+
+### `profile_wallet`
+Full wallet portfolio analysis — holdings, DeFi positions, activity, PnL, risk score.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `address` | string | ✅ | Ethereum/Base wallet address (`0x...`) |
+
+```
+Cost: 0.008 USDC
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/sugi/x402-api-server
+cd x402-api-server/mcp-server
+
+npm install
+npm run build
+npm start
+```
+
+To test without a payment wallet, simply run and see the 402 responses:
+
+```bash
+node dist/index.js
+```
+
+---
+
+## Links
+
+- [x402 API Landing Page](https://x402-api.fly.dev)
+- [x402 Protocol](https://github.com/coinbase/x402)
+- [Base Chain](https://base.org)
+- [ERC-8004 Agent Identity](https://eips.ethereum.org/EIPS/eip-8004)
+- [Agent #18763 on BaseScan](https://basescan.org/address/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432)
+
+---
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * @x402-api/mcp-server
+ *
+ * MCP (Model Context Protocol) server that wraps Sugi's x402 DeFi API.
+ * Gives Claude, ChatGPT, and any MCP-compatible AI agent access to
+ * pay-per-call crypto/DeFi data endpoints.
+ *
+ * ## x402 Payment Protocol
+ *
+ * Every endpoint costs a small USDC micropayment (0.001–0.008 USDC).
+ * Two modes:
+ *
+ * 1. **Auto-pay mode** — Set X402_WALLET_PRIVATE_KEY env var.
+ *    x402-fetch handles the payment automatically. The agent just calls
+ *    the tool and gets data.
+ *
+ * 2. **Manual mode** — No private key set. The tool returns 402 payment
+ *    instructions so you (or the agent) can see what's needed.
+ *
+ * ## Setup
+ *
+ *   export X402_WALLET_PRIVATE_KEY=0x...your_private_key...
+ *   npx @x402-api/mcp-server
+ *
+ * Or in your Claude Desktop config:
+ *   { "command": "npx", "args": ["@x402-api/mcp-server"] }
+ */
+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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/index.js

@@ -0,0 +1,377 @@
+#!/usr/bin/env node
+/**
+ * @x402-api/mcp-server
+ *
+ * MCP (Model Context Protocol) server that wraps Sugi's x402 DeFi API.
+ * Gives Claude, ChatGPT, and any MCP-compatible AI agent access to
+ * pay-per-call crypto/DeFi data endpoints.
+ *
+ * ## x402 Payment Protocol
+ *
+ * Every endpoint costs a small USDC micropayment (0.001–0.008 USDC).
+ * Two modes:
+ *
+ * 1. **Auto-pay mode** — Set X402_WALLET_PRIVATE_KEY env var.
+ *    x402-fetch handles the payment automatically. The agent just calls
+ *    the tool and gets data.
+ *
+ * 2. **Manual mode** — No private key set. The tool returns 402 payment
+ *    instructions so you (or the agent) can see what's needed.
+ *
+ * ## Setup
+ *
+ *   export X402_WALLET_PRIVATE_KEY=0x...your_private_key...
+ *   npx @x402-api/mcp-server
+ *
+ * Or in your Claude Desktop config:
+ *   { "command": "npx", "args": ["@x402-api/mcp-server"] }
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
+// ─── Configuration ────────────────────────────────────────────────────────────
+const API_BASE_URL = process.env.X402_API_BASE_URL || 'https://x402-api.fly.dev';
+const WALLET_PRIVATE_KEY = process.env.X402_WALLET_PRIVATE_KEY;
+const SERVER_VERSION = '1.0.0';
+let _fetchFn = null;
+/**
+ * Returns a fetch function that auto-handles x402 payments if a wallet
+ * private key is configured. Falls back to standard fetch otherwise.
+ */
+async function getX402Fetch() {
+    if (_fetchFn)
+        return _fetchFn;
+    if (WALLET_PRIVATE_KEY) {
+        try {
+            // Dynamic imports for optional dependencies (x402-fetch, viem)
+            const dynImport = new Function('m', 'return import(m)');
+            const x402Module = await dynImport('x402-fetch').catch(() => null);
+            if (x402Module?.wrapFetchWithPayment) {
+                const viemModule = await dynImport('viem');
+                const viemAccounts = await dynImport('viem/accounts');
+                const viemChains = await dynImport('viem/chains');
+                const privateKeyToAccount = viemAccounts['privateKeyToAccount'];
+                const createWalletClient = viemModule['createWalletClient'];
+                const http = viemModule['http'];
+                const base = viemChains['base'];
+                const account = privateKeyToAccount(WALLET_PRIVATE_KEY);
+                const walletClient = createWalletClient({
+                    account,
+                    chain: base,
+                    transport: http(),
+                });
+                const wrapFetch = x402Module['wrapFetchWithPayment'];
+                _fetchFn = wrapFetch(fetch, walletClient);
+                process.stderr.write(`[x402-mcp] Auto-pay enabled. Wallet: ${account.address}\n`);
+                return _fetchFn;
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[x402-mcp] Warning: X402_WALLET_PRIVATE_KEY is set but x402-fetch/viem ` +
+                `are not installed. Falling back to manual mode.\n` +
+                `  Run: npm install x402-fetch viem\n`);
+        }
+    }
+    // Standard fetch — 402s will surface as payment instruction responses
+    _fetchFn = fetch;
+    return _fetchFn;
+}
+async function callApi(endpoint, params = {}) {
+    const url = new URL(`${API_BASE_URL}${endpoint}`);
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== '') {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    const fetchFn = await getX402Fetch();
+    let response;
+    try {
+        response = await fetchFn(url.toString(), {
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': `x402-api-mcp/${SERVER_VERSION}`,
+            },
+        });
+    }
+    catch (err) {
+        throw new McpError(ErrorCode.InternalError, `Network error calling ${endpoint}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (response.status === 402) {
+        let paymentDetails;
+        try {
+            paymentDetails = await response.json();
+        }
+        catch {
+            paymentDetails = await response.text();
+        }
+        return { status: 402, data: null, paymentRequired: true, paymentDetails };
+    }
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new McpError(ErrorCode.InternalError, `API error ${response.status} from ${endpoint}: ${errorText}`);
+    }
+    const data = await response.json();
+    return { status: response.status, data };
+}
+/**
+ * Format a successful API response or payment instructions.
+ */
+function formatResult(result, toolName) {
+    if (result.paymentRequired) {
+        const details = result.paymentDetails;
+        const accepts = details?.accepts;
+        const first = accepts?.[0];
+        let message = `## Payment Required — ${toolName}\n\n`;
+        message += `This endpoint requires a USDC micropayment on Base network.\n\n`;
+        if (first) {
+            const amountRaw = Number(first.maxAmountRequired ?? 0);
+            const amountUsdc = (amountRaw / 1_000_000).toFixed(6);
+            message += `**Cost:** ${amountUsdc} USDC\n`;
+            message += `**Pay to:** \`${first.payTo}\`\n`;
+            message += `**Network:** Base mainnet (chain ID 8453)\n`;
+            message += `**Asset:** USDC (\`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\`)\n\n`;
+        }
+        message += `### To enable automatic payments:\n\n`;
+        message += `1. Install dependencies:\n`;
+        message += `   \`\`\`bash\n   npm install x402-fetch viem\n   \`\`\`\n\n`;
+        message += `2. Set your wallet private key:\n`;
+        message += `   \`\`\`bash\n   export X402_WALLET_PRIVATE_KEY=0x...\n   \`\`\`\n\n`;
+        message += `3. Restart the MCP server.\n\n`;
+        message += `### To pay manually:\n\n`;
+        message += `Send a USDC transfer to the address above on Base, then include `;
+        message += `the transaction hash as \`X-Payment\` header on your request.\n\n`;
+        message += `---\n**Raw 402 response:**\n\`\`\`json\n`;
+        message += JSON.stringify(result.paymentDetails, null, 2);
+        message += `\n\`\`\``;
+        return message;
+    }
+    return JSON.stringify(result.data, null, 2);
+}
+// ─── Tool Definitions ─────────────────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: 'get_crypto_prices',
+        description: 'Get live cryptocurrency prices and top 24h movers. Returns BTC, ETH, SOL prices plus top gainers/losers. ' +
+            'Costs 0.001 USDC per call (x402 micropayment on Base). ' +
+            'Data sourced live from CoinGecko.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'get_gas_prices',
+        description: 'Get current gas prices across multiple chains: Ethereum, Base, Polygon, and Arbitrum. ' +
+            'Returns slow/standard/fast tiers in gwei and estimated USD cost. ' +
+            'Costs 0.001 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'get_dex_quotes',
+        description: 'Compare swap quotes across DEXes: Uniswap, SushiSwap, and 1inch. ' +
+            'Returns best price, price impact, liquidity, and estimated fees for each venue. ' +
+            'Costs 0.002 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                from: {
+                    type: 'string',
+                    description: 'Input token symbol or address (e.g. "ETH", "USDC", "0x...")',
+                },
+                to: {
+                    type: 'string',
+                    description: 'Output token symbol or address (e.g. "USDC", "DAI", "0x...")',
+                },
+                amount: {
+                    type: 'string',
+                    description: 'Amount to swap (e.g. "1.5" for 1.5 ETH)',
+                },
+            },
+            required: ['from', 'to', 'amount'],
+        },
+    },
+    {
+        name: 'scan_token',
+        description: 'Perform a security scan on a token contract. Detects rug-pull risks, honeypot patterns, ' +
+            'ownership concentration, mint authority, and other red flags. ' +
+            'Costs 0.003 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                token: {
+                    type: 'string',
+                    description: 'Token contract address (0x...) or symbol (e.g. "PEPE", "UNI")',
+                },
+            },
+            required: ['token'],
+        },
+    },
+    {
+        name: 'track_whales',
+        description: 'Analyze whale activity and holder concentration for a token. Returns top holders, ' +
+            'Gini coefficient, whale alerts (large recent buys/sells), and distribution breakdown. ' +
+            'Costs 0.005 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                token: {
+                    type: 'string',
+                    description: 'Token contract address (0x...) or symbol (e.g. "ETH", "PEPE")',
+                },
+            },
+            required: ['token'],
+        },
+    },
+    {
+        name: 'scan_yields',
+        description: 'Scan top DeFi yield opportunities across protocols: Aave, Compound, Morpho, Lido, Pendle, and more. ' +
+            'Filter by chain and minimum TVL. Returns APY, TVL, risk score, and protocol details. ' +
+            'Costs 0.005 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                chain: {
+                    type: 'string',
+                    description: 'Blockchain to filter by (e.g. "ethereum", "base", "arbitrum", "polygon"). ' +
+                        'Omit for all chains.',
+                },
+                min_tvl: {
+                    type: 'number',
+                    description: 'Minimum TVL in USD (e.g. 1000000 for $1M). Omit for no minimum.',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'get_funding_rates',
+        description: 'Get perpetual futures funding rates across 6 venues (Binance, OKX, Bybit, dYdX, GMX, Hyperliquid). ' +
+            'Returns current rates, 7d average, annualized rate, and arbitrage opportunity ranking. ' +
+            'Costs 0.008 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                asset: {
+                    type: 'string',
+                    description: 'Asset symbol (e.g. "BTC", "ETH", "SOL"). Returns all assets if omitted.',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'profile_wallet',
+        description: 'Generate a full portfolio profile for an Ethereum/Base wallet address. ' +
+            'Returns token holdings, NFTs, DeFi positions, transaction history summary, ' +
+            'PnL estimate, and risk profile score. ' +
+            'Costs 0.008 USDC per call (x402 micropayment on Base).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: {
+                    type: 'string',
+                    description: 'Ethereum or Base wallet address (0x...)',
+                },
+            },
+            required: ['address'],
+        },
+    },
+];
+// ─── MCP Server ───────────────────────────────────────────────────────────────
+const server = new Server({
+    name: 'x402-api-mcp',
+    version: SERVER_VERSION,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools handler
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+// Call tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const params = (args ?? {});
+    let result;
+    switch (name) {
+        case 'get_crypto_prices':
+            result = await callApi('/api/price-feed');
+            break;
+        case 'get_gas_prices':
+            result = await callApi('/api/gas-tracker');
+            break;
+        case 'get_dex_quotes':
+            if (!params.from || !params.to || !params.amount) {
+                throw new McpError(ErrorCode.InvalidParams, 'get_dex_quotes requires: from, to, amount');
+            }
+            result = await callApi('/api/dex-quotes', {
+                from: params.from,
+                to: params.to,
+                amount: params.amount,
+            });
+            break;
+        case 'scan_token':
+            if (!params.token) {
+                throw new McpError(ErrorCode.InvalidParams, 'scan_token requires: token');
+            }
+            result = await callApi('/api/token-scanner', { token: params.token });
+            break;
+        case 'track_whales':
+            if (!params.token) {
+                throw new McpError(ErrorCode.InvalidParams, 'track_whales requires: token');
+            }
+            result = await callApi('/api/whale-tracker', { token: params.token });
+            break;
+        case 'scan_yields':
+            result = await callApi('/api/yield-scanner', {
+                chain: params.chain,
+                min_tvl: params.min_tvl,
+            });
+            break;
+        case 'get_funding_rates':
+            result = await callApi('/api/funding-rates', { asset: params.asset });
+            break;
+        case 'profile_wallet':
+            if (!params.address) {
+                throw new McpError(ErrorCode.InvalidParams, 'profile_wallet requires: address');
+            }
+            result = await callApi('/api/wallet-profiler', { address: params.address });
+            break;
+        default:
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    const text = formatResult(result, name);
+    return {
+        content: [
+            {
+                type: 'text',
+                text,
+            },
+        ],
+        isError: false,
+    };
+});
+// ─── Start ────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const payMode = WALLET_PRIVATE_KEY
+        ? 'AUTO-PAY (x402-fetch)'
+        : 'MANUAL (returns 402 payment instructions)';
+    process.stderr.write(`[x402-mcp] Server started\n` +
+        `[x402-mcp] API: ${API_BASE_URL}\n` +
+        `[x402-mcp] Payment mode: ${payMode}\n` +
+        `[x402-mcp] Tools: ${TOOLS.map((t) => t.name).join(', ')}\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[x402-mcp] Fatal error: ${err}\n`);
+    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":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@x402-api/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Sugi's x402 DeFi API — gives Claude, ChatGPT, and MCP-compatible agents access to pay-per-call crypto/DeFi data",
+  "type": "module",
+  "bin": {
+    "x402-api-mcp": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "x402",
+    "defi",
+    "crypto",
+    "ai-agent",
+    "claude",
+    "usdc",
+    "base",
+    "price-feed",
+    "gas-tracker",
+    "dex",
+    "yield",
+    "whale-tracker",
+    "funding-rates",
+    "wallet-profiler"
+  ],
+  "author": "Sugi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fernsugi/x402-api-server",
+    "directory": "mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "optionalDependencies": {
+    "viem": "^2.0.0",
+    "x402-fetch": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}