@obolos_tech/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,111 @@
+# Obolos MCP Server
+
+**Let AI agents discover and pay for APIs on the Obolos x402 marketplace.**
+
+Every API on the Obolos marketplace becomes a tool your AI agent can call — with automatic USDC micropayments on Base.
+
+## Quick Setup
+
+### Claude Code
+
+```bash
+claude mcp add obolos -- node /path/to/mcp-server/dist/index.js
+```
+
+Or with a payment wallet:
+
+```bash
+claude mcp add obolos -e OBOLOS_PRIVATE_KEY=0xyour_private_key -- node /path/to/mcp-server/dist/index.js
+```
+
+### Claude Desktop
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "obolos": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/dist/index.js"],
+      "env": {
+        "OBOLOS_PRIVATE_KEY": "0xyour_private_key"
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf / Other MCP Clients
+
+Add to your MCP config:
+
+```json
+{
+  "obolos": {
+    "command": "node",
+    "args": ["/path/to/mcp-server/dist/index.js"],
+    "env": {
+      "OBOLOS_PRIVATE_KEY": "0xyour_private_key"
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_apis` | Search the marketplace by query, category, or sort order |
+| `list_categories` | Browse available API categories |
+| `get_api_details` | Get full details, input fields, and pricing for an API |
+| `call_api` | Execute an API with automatic x402 USDC payment |
+| `get_balance` | Check your wallet's USDC balance on Base |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OBOLOS_PRIVATE_KEY` | For payments | Private key of a Base wallet with USDC |
+| `OBOLOS_API_URL` | No | Marketplace URL (default: `https://obolos.tech`) |
+
+## Example Usage
+
+Once configured, your AI agent can:
+
+```
+"Search for token price APIs on Obolos"
+→ search_apis(query: "token price")
+
+"How much does the DeFi portfolio API cost?"
+→ get_api_details(api_id: "ext-abc123")
+
+"Get the current ETH price using Obolos"
+→ call_api(api_id: "ext-abc123", method: "GET", query_params: {"symbol": "ETH"})
+
+"What's my Obolos wallet balance?"
+→ get_balance()
+```
+
+## How Payments Work
+
+1. Agent calls `call_api` with an API id and parameters
+2. MCP server sends request to Obolos proxy
+3. Proxy returns HTTP 402 with payment requirements
+4. Server signs an EIP-712 payment with your private key
+5. Retries request with payment header
+6. API response is returned to the agent
+
+Payments are USDC micropayments on Base ($0.001–$0.10 per call). Only 1% platform fee — 99% goes directly to the API creator.
+
+## Build from Source
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Obolos MCP Server
+ *
+ * Exposes the Obolos x402 API marketplace as MCP tools.
+ * Any AI agent (Claude Code, Cursor, Windsurf, etc.) can discover,
+ * browse, and pay for APIs through this server.
+ *
+ * Configuration (env vars):
+ *   OBOLOS_API_URL     — Marketplace URL (default: https://obolos.tech)
+ *   OBOLOS_PRIVATE_KEY — Wallet private key for x402 payments (optional)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env node
+/**
+ * Obolos MCP Server
+ *
+ * Exposes the Obolos x402 API marketplace as MCP tools.
+ * Any AI agent (Claude Code, Cursor, Windsurf, etc.) can discover,
+ * browse, and pay for APIs through this server.
+ *
+ * Configuration (env vars):
+ *   OBOLOS_API_URL     — Marketplace URL (default: https://obolos.tech)
+ *   OBOLOS_PRIVATE_KEY — Wallet private key for x402 payments (optional)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { MarketplaceClient } from './marketplace.js';
+import { PaymentSigner } from './payment.js';
+const OBOLOS_API_URL = process.env.OBOLOS_API_URL || 'https://obolos.tech';
+const OBOLOS_PRIVATE_KEY = process.env.OBOLOS_PRIVATE_KEY || '';
+const marketplace = new MarketplaceClient(OBOLOS_API_URL);
+const signer = OBOLOS_PRIVATE_KEY ? new PaymentSigner(OBOLOS_PRIVATE_KEY) : null;
+const server = new McpServer({
+    name: 'obolos',
+    version: '0.1.0',
+});
+// ─── Tool: search_apis ──────────────────────────────────────────────────────
+server.tool('search_apis', 'Search the Obolos x402 marketplace for pay-per-call APIs. ' +
+    'Returns APIs that AI agents can call with automatic USDC micropayments. ' +
+    'Use this to find data services, AI endpoints, blockchain tools, and more.', {
+    query: z.string().optional().describe('Search query (e.g. "weather", "token price", "web scraping")'),
+    category: z.string().optional().describe('Filter by category'),
+    sort: z.enum(['popular', 'newest', 'price_asc', 'price_desc']).optional()
+        .describe('Sort order. Default: popular'),
+    limit: z.number().min(1).max(50).optional().describe('Max results (default 20)'),
+}, async ({ query, category, sort, limit }) => {
+    try {
+        const result = await marketplace.searchApis({
+            query,
+            category,
+            sort,
+            limit: limit || 20,
+        });
+        const summary = result.apis.map((api) => ({
+            id: api.id,
+            name: api.name,
+            description: api.description?.slice(0, 200),
+            category: api.category,
+            price: `$${api.price_per_call.toFixed(4)} USDC`,
+            method: api.http_method,
+            type: api.api_type,
+            rating: api.average_rating ? `${api.average_rating.toFixed(1)}/5` : 'unrated',
+            calls: api.total_calls,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        total: result.pagination.total,
+                        showing: summary.length,
+                        apis: summary,
+                        tip: 'Use get_api_details with an API id to see full details including input fields. Use call_api to execute.',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error searching APIs: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Tool: list_categories ──────────────────────────────────────────────────
+server.tool('list_categories', 'List all API categories available on the Obolos marketplace. ' +
+    'Useful for browsing what types of APIs are available.', {}, async () => {
+    try {
+        const result = await marketplace.getCategories();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        categories: result.categories,
+                        total_native_apis: result.nativeCount,
+                        total_external_apis: result.externalCount,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Tool: get_api_details ──────────────────────────────────────────────────
+server.tool('get_api_details', 'Get full details for a specific API including input fields, pricing, ' +
+    'example request/response, and how to call it. Use an API id from search_apis.', {
+    api_id: z.string().describe('The API id (e.g. "ext-a1b2c3d4" for external, or a UUID for native)'),
+}, async ({ api_id }) => {
+    try {
+        const api = await marketplace.getApiDetails(api_id);
+        const details = {
+            id: api.id,
+            name: api.name,
+            description: api.description,
+            category: api.category,
+            price: `$${api.price_per_call.toFixed(4)} USDC per call`,
+            method: api.http_method,
+            type: api.api_type,
+            rating: api.average_rating ? `${api.average_rating.toFixed(1)}/5 (${api.review_count} reviews)` : 'unrated',
+            total_calls: api.total_calls,
+            seller: api.seller_name,
+        };
+        if (api.input_schema) {
+            details.input_fields = api.input_schema;
+        }
+        if (api.example_request) {
+            try {
+                details.example_request = JSON.parse(api.example_request);
+            }
+            catch {
+                details.example_request = api.example_request;
+            }
+        }
+        if (api.example_response) {
+            try {
+                details.example_response = JSON.parse(api.example_response);
+            }
+            catch {
+                details.example_response = api.example_response;
+            }
+        }
+        details.how_to_call = {
+            tool: 'call_api',
+            params: {
+                api_id: api.id,
+                method: api.http_method,
+                body: api.input_schema?.fields
+                    ? Object.fromEntries(Object.entries(api.input_schema.fields).map(([k, v]) => [
+                        k,
+                        v.example ?? `<${v.type}>`,
+                    ]))
+                    : undefined,
+            },
+            note: signer
+                ? `Payment will be signed automatically with wallet ${signer.address}`
+                : 'Set OBOLOS_PRIVATE_KEY env var to enable automatic payments',
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(details, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Tool: call_api ─────────────────────────────────────────────────────────
+server.tool('call_api', 'Execute an API call on the Obolos marketplace with automatic x402 USDC payment. ' +
+    'Requires OBOLOS_PRIVATE_KEY env var to be set. ' +
+    'The payment is a micropayment (typically $0.001–$0.01 USDC per call).', {
+    api_id: z.string().describe('The API id to call'),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH']).optional().describe('HTTP method (default: GET)'),
+    body: z.record(z.unknown()).optional().describe('Request body (for POST/PUT/PATCH)'),
+    query_params: z.record(z.string()).optional().describe('Query parameters (for GET)'),
+}, async ({ api_id, method, body, query_params }) => {
+    if (!signer) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Payment not configured. Set the OBOLOS_PRIVATE_KEY environment variable ' +
+                        'with a Base wallet private key that has USDC balance.\n\n' +
+                        'Example: OBOLOS_PRIVATE_KEY=0xabc123... in your MCP server config.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await marketplace.callApi(api_id, {
+            method,
+            body,
+            queryParams: query_params,
+            signPayment: async (paymentRequired) => {
+                return signer.signPayment(paymentRequired);
+            },
+        });
+        if (result.status >= 400) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: true,
+                            status: result.status,
+                            body: result.body,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: result.status,
+                        data: result.body,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `API call failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Tool: get_balance ──────────────────────────────────────────────────────
+server.tool('get_balance', 'Check the USDC balance of the configured payment wallet on Base.', {}, async () => {
+    if (!signer) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No wallet configured. Set OBOLOS_PRIVATE_KEY env var.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const balance = await signer.getUsdcBalance();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        address: signer.address,
+                        usdc_balance: `${balance.formatted} USDC`,
+                        network: 'Base (Chain ID: 8453)',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Balance check failed: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Resources ──────────────────────────────────────────────────────────────
+server.resource('marketplace-info', 'obolos://marketplace/info', async () => ({
+    contents: [
+        {
+            uri: 'obolos://marketplace/info',
+            mimeType: 'application/json',
+            text: JSON.stringify({
+                name: 'Obolos x402 Marketplace',
+                url: OBOLOS_API_URL,
+                description: 'Pay-per-call API marketplace powered by x402 micropayments. ' +
+                    'Browse and call hundreds of APIs with automatic USDC payments on Base. ' +
+                    'Only 1% platform fee — 99% goes directly to API creators.',
+                wallet: signer
+                    ? { address: signer.address, configured: true }
+                    : { configured: false, note: 'Set OBOLOS_PRIVATE_KEY to enable payments' },
+                documentation: 'https://obolos.tech/app/marketplace',
+            }, null, 2),
+        },
+    ],
+}));
+// ─── Start ──────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[obolos-mcp] Connected to ${OBOLOS_API_URL}`);
+    if (signer) {
+        console.error(`[obolos-mcp] Wallet: ${signer.address}`);
+    }
+    else {
+        console.error('[obolos-mcp] No wallet configured (set OBOLOS_PRIVATE_KEY for payments)');
+    }
+}
+main().catch((err) => {
+    console.error('[obolos-mcp] Fatal:', err);
+    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/dist/marketplace.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Obolos Marketplace API Client
+ * Fetches API catalog from the Obolos marketplace backend
+ */
+import type { MarketplaceApi, MarketplaceListResponse, MarketplaceSearchResponse, CategoryResponse } from './types.js';
+export declare class MarketplaceClient {
+    private baseUrl;
+    constructor(baseUrl: string);
+    /**
+     * List all marketplace APIs with optional category filter
+     */
+    listApis(options?: {
+        category?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<MarketplaceListResponse>;
+    /**
+     * Search APIs by query, category, and sort order
+     */
+    searchApis(options: {
+        query?: string;
+        category?: string;
+        sort?: 'popular' | 'newest' | 'price_asc' | 'price_desc';
+        page?: number;
+        limit?: number;
+    }): Promise<MarketplaceSearchResponse>;
+    /**
+     * Get full details for a single API
+     */
+    getApiDetails(id: string): Promise<MarketplaceApi>;
+    /**
+     * List all available categories
+     */
+    getCategories(): Promise<CategoryResponse>;
+    /**
+     * Call an API via the Obolos proxy.
+     * Handles the x402 payment flow: initial request → 402 → sign → retry.
+     */
+    callApi(apiId: string, options: {
+        method?: string;
+        body?: Record<string, unknown>;
+        queryParams?: Record<string, string>;
+        signPayment: (paymentRequired: any) => Promise<Record<string, string>>;
+    }): Promise<{
+        status: number;
+        headers: Record<string, string>;
+        body: unknown;
+    }>;
+}

package/dist/marketplace.js

@@ -0,0 +1,138 @@
+/**
+ * Obolos Marketplace API Client
+ * Fetches API catalog from the Obolos marketplace backend
+ */
+export class MarketplaceClient {
+    baseUrl;
+    constructor(baseUrl) {
+        // Strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+    }
+    /**
+     * List all marketplace APIs with optional category filter
+     */
+    async listApis(options) {
+        const params = new URLSearchParams();
+        if (options?.category)
+            params.set('category', options.category);
+        if (options?.page)
+            params.set('page', String(options.page));
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        params.set('type', 'native');
+        const url = `${this.baseUrl}/api/marketplace/apis?${params}`;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Marketplace list failed: ${res.status} ${res.statusText}`);
+        return res.json();
+    }
+    /**
+     * Search APIs by query, category, and sort order
+     */
+    async searchApis(options) {
+        const params = new URLSearchParams();
+        if (options.query)
+            params.set('q', options.query);
+        if (options.category)
+            params.set('category', options.category);
+        if (options.sort)
+            params.set('sort', options.sort);
+        if (options.page)
+            params.set('page', String(options.page));
+        if (options.limit)
+            params.set('limit', String(options.limit));
+        params.set('type', 'native');
+        const url = `${this.baseUrl}/api/marketplace/apis/search?${params}`;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Marketplace search failed: ${res.status} ${res.statusText}`);
+        return res.json();
+    }
+    /**
+     * Get full details for a single API
+     */
+    async getApiDetails(id) {
+        const url = `${this.baseUrl}/api/marketplace/apis/${encodeURIComponent(id)}`;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`API detail fetch failed: ${res.status} ${res.statusText}`);
+        return res.json();
+    }
+    /**
+     * List all available categories
+     */
+    async getCategories() {
+        const url = `${this.baseUrl}/api/marketplace/categories`;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Categories fetch failed: ${res.status} ${res.statusText}`);
+        return res.json();
+    }
+    /**
+     * Call an API via the Obolos proxy.
+     * Handles the x402 payment flow: initial request → 402 → sign → retry.
+     */
+    async callApi(apiId, options) {
+        const method = (options.method || 'GET').toUpperCase();
+        const proxyUrl = new URL(`${this.baseUrl}/api/proxy/${encodeURIComponent(apiId)}`);
+        if (options.queryParams) {
+            for (const [k, v] of Object.entries(options.queryParams)) {
+                proxyUrl.searchParams.set(k, v);
+            }
+        }
+        const fetchOptions = { method };
+        if (method !== 'GET' && options.body) {
+            fetchOptions.headers = { 'Content-Type': 'application/json' };
+            fetchOptions.body = JSON.stringify(options.body);
+        }
+        // First request — expect 402
+        let response = await fetch(proxyUrl.toString(), fetchOptions);
+        if (response.status === 402) {
+            // Parse payment requirements from body (v1 format) or header (v2)
+            let paymentInfo;
+            try {
+                paymentInfo = await response.json();
+            }
+            catch {
+                throw new Error('Got 402 but could not parse payment requirements');
+            }
+            // Ask caller to sign the payment
+            const paymentHeaders = await options.signPayment(paymentInfo);
+            // Retry with payment
+            const paidFetchOptions = {
+                ...fetchOptions,
+                headers: {
+                    ...(fetchOptions.headers || {}),
+                    ...paymentHeaders,
+                },
+            };
+            response = await fetch(proxyUrl.toString(), paidFetchOptions);
+        }
+        // Collect response headers
+        const responseHeaders = {};
+        response.headers.forEach((v, k) => {
+            responseHeaders[k] = v;
+        });
+        // Parse response body
+        const contentType = response.headers.get('content-type') || '';
+        let body;
+        if (contentType.includes('application/json')) {
+            body = await response.json();
+        }
+        else if (contentType.includes('text/')) {
+            body = await response.text();
+        }
+        else {
+            // Binary — return base64
+            const buffer = await response.arrayBuffer();
+            body = {
+                _binary: true,
+                contentType,
+                base64: Buffer.from(buffer).toString('base64'),
+                size: buffer.byteLength,
+            };
+        }
+        return { status: response.status, headers: responseHeaders, body };
+    }
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/marketplace.js.map

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

package/dist/payment.d.ts

@@ -0,0 +1,26 @@
+/**
+ * x402 Payment Signing for MCP Server
+ *
+ * Signs x402 payment requests using a private key (no browser wallet needed).
+ * Supports both v1 (exact) and v2 (x402x-router-settlement) payment schemes.
+ */
+export declare class PaymentSigner {
+    private account;
+    private client;
+    constructor(privateKey: string);
+    get address(): string;
+    /**
+     * Get USDC balance for the signing wallet
+     */
+    getUsdcBalance(): Promise<{
+        raw: bigint;
+        formatted: string;
+    }>;
+    /**
+     * Sign an x402 payment request and return the payment headers.
+     *
+     * This handles the EIP-712 typed data signing that the x402 protocol requires.
+     * Works with both v1 (exact scheme) and v2 format 402 responses.
+     */
+    signPayment(paymentRequired: any): Promise<Record<string, string>>;
+}

package/dist/payment.js

@@ -0,0 +1,137 @@
+/**
+ * x402 Payment Signing for MCP Server
+ *
+ * Signs x402 payment requests using a private key (no browser wallet needed).
+ * Supports both v1 (exact) and v2 (x402x-router-settlement) payment schemes.
+ */
+import { createWalletClient, http, publicActions, formatUnits, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { base } from 'viem/chains';
+const USDC_ADDRESS = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const USDC_ABI = [
+    {
+        inputs: [{ name: 'account', type: 'address' }],
+        name: 'balanceOf',
+        outputs: [{ name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+export class PaymentSigner {
+    account;
+    client;
+    constructor(privateKey) {
+        if (!privateKey.startsWith('0x')) {
+            privateKey = `0x${privateKey}`;
+        }
+        this.account = privateKeyToAccount(privateKey);
+        this.client = createWalletClient({
+            account: this.account,
+            chain: base,
+            transport: http(),
+        }).extend(publicActions);
+    }
+    get address() {
+        return this.account.address;
+    }
+    /**
+     * Get USDC balance for the signing wallet
+     */
+    async getUsdcBalance() {
+        const balance = await this.client.readContract({
+            address: USDC_ADDRESS,
+            abi: USDC_ABI,
+            functionName: 'balanceOf',
+            args: [this.account.address],
+        });
+        return {
+            raw: balance,
+            formatted: formatUnits(balance, 6),
+        };
+    }
+    /**
+     * Sign an x402 payment request and return the payment headers.
+     *
+     * This handles the EIP-712 typed data signing that the x402 protocol requires.
+     * Works with both v1 (exact scheme) and v2 format 402 responses.
+     */
+    async signPayment(paymentRequired) {
+        // Extract payment details from the 402 response
+        const accepts = paymentRequired.accepts;
+        if (!accepts || accepts.length === 0) {
+            throw new Error('No payment options in 402 response');
+        }
+        const requirement = accepts[0];
+        const scheme = requirement.scheme || 'exact';
+        const network = requirement.network || 'base';
+        const amount = requirement.maxAmountRequired || requirement.amount;
+        const payTo = requirement.payTo;
+        const asset = requirement.asset || USDC_ADDRESS;
+        if (!amount || !payTo) {
+            throw new Error('Missing amount or payTo in payment requirement');
+        }
+        // Build EIP-712 typed data for the exact scheme
+        const deadline = BigInt(Math.floor(Date.now() / 1000) + 300); // 5 min
+        const amountBigInt = BigInt(amount);
+        const domain = {
+            name: 'x402',
+            version: '1',
+            chainId: 8453n,
+            verifyingContract: asset,
+        };
+        const types = {
+            TransferWithAuthorization: [
+                { name: 'from', type: 'address' },
+                { name: 'to', type: 'address' },
+                { name: 'value', type: 'uint256' },
+                { name: 'validAfter', type: 'uint256' },
+                { name: 'validBefore', type: 'uint256' },
+                { name: 'nonce', type: 'bytes32' },
+            ],
+        };
+        // Generate a random nonce
+        const nonceBytes = new Uint8Array(32);
+        crypto.getRandomValues(nonceBytes);
+        const nonce = `0x${Array.from(nonceBytes).map(b => b.toString(16).padStart(2, '0')).join('')}`;
+        const message = {
+            from: this.account.address,
+            to: payTo,
+            value: amountBigInt,
+            validAfter: 0n,
+            validBefore: deadline,
+            nonce,
+        };
+        const signature = await this.client.signTypedData({
+            account: this.account,
+            domain,
+            types,
+            primaryType: 'TransferWithAuthorization',
+            message,
+        });
+        // Build the payment payload
+        const paymentPayload = {
+            x402Version: paymentRequired.x402Version || 1,
+            scheme,
+            network,
+            payload: {
+                signature,
+                authorization: {
+                    from: this.account.address,
+                    to: payTo,
+                    value: amount.toString(),
+                    validAfter: '0',
+                    validBefore: deadline.toString(),
+                    nonce,
+                },
+            },
+        };
+        // Encode as base64 for the payment header
+        const encoded = Buffer.from(JSON.stringify(paymentPayload)).toString('base64');
+        // Return appropriate headers based on version
+        if (paymentRequired.x402Version === 2) {
+            return { 'payment-signature': encoded };
+        }
+        return { 'x-payment': encoded };
+    }
+}
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Type definitions for the Obolos MCP Server
+ */
+export interface MarketplaceApi {
+    id: string;
+    name: string;
+    slug: string | null;
+    description: string;
+    category: string;
+    price_per_call: number;
+    http_method: string;
+    seller_name: string;
+    total_calls: number;
+    example_request: string | null;
+    example_response: string | null;
+    api_type: 'native' | 'external';
+    average_rating: number | null;
+    review_count: number;
+    input_schema?: InputSchema | null;
+    input_type?: string;
+    response_type?: string;
+    proxy_endpoint?: string;
+    resource_url?: string;
+}
+export interface InputSchema {
+    method: string;
+    bodyType: string;
+    fields: Record<string, FieldSchema>;
+    exampleResponse?: unknown;
+}
+export interface FieldSchema {
+    type: string;
+    required?: boolean;
+    example?: unknown;
+    description?: string;
+    enum?: string[];
+}
+export interface MarketplaceListResponse {
+    apis: MarketplaceApi[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        total_pages: number;
+        has_next: boolean;
+        has_prev: boolean;
+    };
+    timestamp: string;
+}
+export interface MarketplaceSearchResponse extends MarketplaceListResponse {
+    query: string | null;
+    category: string | null;
+    sort: string;
+}
+export interface CategoryResponse {
+    categories: Array<{
+        name: string;
+        count: number;
+    }>;
+    nativeCount: number;
+    externalCount: number;
+    count: number;
+}
+export interface PaymentRequiredResponse {
+    x402Version: number;
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        maxAmountRequired?: string;
+        amount?: string;
+        resource?: string;
+        payTo: string;
+        asset: string;
+    }>;
+    error?: string;
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the Obolos MCP Server
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@obolos_tech/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Obolos x402 API marketplace — lets AI agents discover and pay for APIs",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": ["dist", "README.md"],
+  "bin": {
+    "obolos-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "x402",
+    "obolos",
+    "ai-agents",
+    "micropayments",
+    "marketplace"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "viem": "^2.45.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}