@fluxa-pay/fluxa-connect-mcp 0.1.4

package/README.md

@@ -0,0 +1,62 @@
+# FluxA Connect MCP
+
+Automatic X402 payment handling for MCP servers in Claude Code.
+
+## Installation
+
+```bash
+npx @fluxa-pay/fluxa-connect-mcp@latest --url <mcp-server-url>
+```
+
+## Usage with Claude Code
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@fluxa-pay/fluxa-connect-mcp@latest",
+        "--url",
+        "https://api.fluxapay.xyz/mcp/<your-config-id>"
+      ],
+      "env": {
+        "AGENT_EMAIL": "your@email.com",
+        "AGENT_NAME": "Claude Code - agentwallet.fluxapay.xyz",
+        "CLIENT_INFO": "Claude Code on macOS",
+      }
+    }
+  }
+}
+```
+
+To use it directly
+```bash
+claude mcp add-json <your-config-id> '{"command":"npx","args":["-y","@fluxa-pay/fluxa-connect-mcp","--url","https://fluxa-servers-connection.up.railway.app/mcp/<config-id>"],"env":{"AGENT_EMAIL":"your@email.com","AGENT_NAME":"Claude Code - agentwallet.fluxapay.xyz","CLIENT_INFO":"Claude Code on macOS"}}'
+```
+
+## Required Environment Variables
+
+- `AGENT_EMAIL` - Your email address
+- `AGENT_NAME` - A name for your agent (e.g., "Claude Code - John's Laptop")
+
+## Optional Environment Variables
+
+- `EVM_NETWORK` - Payment network (default: `base`)
+  - Supported: `base`, `base-sepolia`, `avalanche`, `avalanche-fuji`, `iotex`, `sei`, `sei-testnet`, `polygon-amoy`, `solana`, `solana-devnet`
+
+## Troubleshooting
+
+**Agent not authorized?**
+Open the authorization link provided in the error message.
+
+**Payment needs approval?**
+Open the approval link provided in the error message.
+
+## Our website
+
+Visit us at [FluxA](https://www.fluxapay.xyz/)
+

package/dist/payment-client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Custom X402 Payment Client Wrapper
+ * Uses FluxA Wallet Service for payment signing
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+interface PaymentOption {
+    scheme: string;
+    network: string;
+    maxAmountRequired: string;
+    payTo: string;
+    asset: string;
+    maxTimeoutSeconds: number;
+    resource: string;
+    mimeType: string;
+    description: string;
+    extra?: any;
+}
+interface PaymentClientConfig {
+    fluxaWalletServiceUrl: string;
+    agentJwt: string;
+    agentName: string;
+    network: string;
+    confirmationCallback?: (options: PaymentOption[]) => Promise<boolean>;
+}
+export declare function createPaymentClient(client: Client, config: PaymentClientConfig): Client<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+}>;
+export {};
+//# sourceMappingURL=payment-client.d.ts.map

package/dist/payment-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-client.d.ts","sourceRoot":"","sources":["../payment-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGxE,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,UAAU,mBAAmB;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAQD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;GAuL5B"}

package/dist/payment-client.js

@@ -0,0 +1,162 @@
+/**
+ * Custom X402 Payment Client Wrapper
+ * Uses FluxA Wallet Service for payment signing
+ */
+import axios from 'axios';
+export function createPaymentClient(client, config) {
+    const { fluxaWalletServiceUrl, agentJwt, agentName, network, confirmationCallback } = config;
+    // Store the original callTool method
+    const originalCallTool = client.callTool.bind(client);
+    // Override callTool with payment logic
+    client.callTool = async (params, resultSchema, options) => {
+        console.error('[CUSTOM-PAYMENT-CLIENT] Calling tool:', params.name);
+        // First attempt - call without payment
+        let result = await originalCallTool(params, resultSchema, options);
+        // Check if payment is required
+        const paymentError = result._meta?.['x402/error'];
+        if (result.isError && paymentError?.accepts) {
+            console.error('[CUSTOM-PAYMENT-CLIENT] Payment required');
+            const paymentOptions = paymentError.accepts;
+            // Show payment options to user (if callback provided)
+            if (confirmationCallback) {
+                const approved = await confirmationCallback(paymentOptions);
+                if (!approved) {
+                    console.error('[CUSTOM-PAYMENT-CLIENT] Payment declined by user');
+                    return {
+                        isError: true,
+                        content: [{ type: 'text', text: 'Payment declined' }]
+                    };
+                }
+            }
+            // Find payment option for our network
+            const selectedOption = paymentOptions.find(opt => opt.network === network);
+            if (!selectedOption) {
+                console.error(`[CUSTOM-PAYMENT-CLIENT] No payment option for network: ${network}`);
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `Payment network ${network} not supported` }]
+                };
+            }
+            console.error('[CUSTOM-PAYMENT-CLIENT] Creating payment via FluxA Wallet Service...');
+            // Extract host from resource URL
+            let host;
+            try {
+                const resourceUrl = new URL(selectedOption.resource);
+                host = resourceUrl.hostname;
+            }
+            catch {
+                // If resource is not a full URL, try to extract from scheme
+                host = selectedOption.resource.replace('mcp://', '').split('/')[0];
+            }
+            // Call FluxA Wallet Service to create payment
+            let paymentResponse;
+            try {
+                const requestData = {
+                    scheme: selectedOption.scheme,
+                    network: selectedOption.network,
+                    amount: selectedOption.maxAmountRequired,
+                    currency: 'USDC',
+                    assetAddress: selectedOption.asset,
+                    payTo: selectedOption.payTo,
+                    host: host,
+                    resource: selectedOption.resource,
+                    description: selectedOption.description,
+                    tokenName: selectedOption.extra?.name || 'USDC',
+                    tokenVersion: selectedOption.extra?.version || '2',
+                    validityWindowSeconds: selectedOption.maxTimeoutSeconds || 60
+                };
+                // Sanitize URL - ensure no double slashes
+                const baseUrl = fluxaWalletServiceUrl.endsWith('/')
+                    ? fluxaWalletServiceUrl.slice(0, -1)
+                    : fluxaWalletServiceUrl;
+                const paymentUrl = `${baseUrl}/api/payment/x402V1Payment`;
+                console.error('[CUSTOM-PAYMENT-CLIENT] Request URL:', paymentUrl);
+                console.error('[CUSTOM-PAYMENT-CLIENT] JWT length:', agentJwt.length);
+                console.error('[CUSTOM-PAYMENT-CLIENT] JWT (first 50 chars):', agentJwt.substring(0, 50));
+                console.error('[CUSTOM-PAYMENT-CLIENT] Request data:', JSON.stringify(requestData, null, 2));
+                const response = await axios.post(paymentUrl, requestData, {
+                    headers: {
+                        'Authorization': `Bearer ${agentJwt}`,
+                        'Content-Type': 'application/json'
+                    }
+                });
+                paymentResponse = response.data;
+                console.error('[CUSTOM-PAYMENT-CLIENT] Payment response status:', paymentResponse.status);
+            }
+            catch (error) {
+                console.error('[CUSTOM-PAYMENT-CLIENT] FluxA Wallet Service error:', error.message);
+                if (error.response) {
+                    console.error('[CUSTOM-PAYMENT-CLIENT] Response status:', error.response.status);
+                    console.error('[CUSTOM-PAYMENT-CLIENT] Response data:', JSON.stringify(error.response.data, null, 2));
+                    const errorData = error.response.data;
+                    // If there's a payment_model_context with agent_not_found, build authorization link
+                    if (errorData.payment_model_context && errorData.code === 'agent_not_found') {
+                        const instructions = errorData.payment_model_context.instructions || '';
+                        // Extract agent_id from instructions (it's in the error message)
+                        const agentIdMatch = instructions.match(/ID:\s*([a-f0-9-]+)/i);
+                        const agentId = agentIdMatch ? agentIdMatch[1] : '';
+                        let message = `Payment failed: ${errorData.message || error.message}\n\n`;
+                        if (agentId) {
+                            const encodedName = encodeURIComponent(agentName);
+                            const authUrl = `https://agentwallet.fluxapay.xyz/add-agent?agentId=${agentId}&name=${encodedName}`;
+                            message += `Your agent needs to be authorized in FluxA wallet.\n\n`;
+                            message += `Please open this link to authorize:\n${authUrl}\n\n`;
+                            message += `After authorization, please retry this request.`;
+                        }
+                        else {
+                            message += instructions;
+                        }
+                        return {
+                            isError: true,
+                            content: [{
+                                    type: 'text',
+                                    text: message
+                                }]
+                        };
+                    }
+                    // For other payment_model_context errors, pass through instructions
+                    if (errorData.payment_model_context) {
+                        const instructions = errorData.payment_model_context.instructions || '';
+                        return {
+                            isError: true,
+                            content: [{
+                                    type: 'text',
+                                    text: `Payment failed: ${errorData.message || error.message}\n\n${instructions}`
+                                }]
+                        };
+                    }
+                }
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `Payment creation failed: ${error.message}` }]
+                };
+            }
+            // Check if payment needs user approval
+            if (paymentResponse.status === 'need_approval') {
+                console.error('[CUSTOM-PAYMENT-CLIENT] Payment requires user approval:', paymentResponse.approvalUrl);
+                return {
+                    isError: true,
+                    content: [{
+                            type: 'text',
+                            text: `Payment requires approval. Please visit: ${paymentResponse.approvalUrl}\nThen retry this operation.`
+                        }]
+                };
+            }
+            // Encode payment as base64
+            const paymentToken = Buffer.from(JSON.stringify(paymentResponse.xPayment || paymentResponse)).toString('base64');
+            console.error('[CUSTOM-PAYMENT-CLIENT] Payment token created, retrying with payment...');
+            // Retry with payment token
+            result = await originalCallTool({
+                ...params,
+                _meta: {
+                    ...(params._meta || {}),
+                    'x402/payment': paymentToken
+                }
+            }, resultSchema, options);
+            console.error('[CUSTOM-PAYMENT-CLIENT] Tool call with payment completed');
+        }
+        return result;
+    };
+    return client;
+}
+//# sourceMappingURL=payment-client.js.map

package/dist/payment-client.js.map

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

package/dist/stdio-server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * MCP Stdio Server that wraps an X402 payment-enabled client
+ * This allows Claude Code to connect via stdio while the server handles payments internally
+ */
+export {};
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/stdio-server.d.ts.map

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

package/dist/stdio-server.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * MCP Stdio Server that wraps an X402 payment-enabled client
+ * This allows Claude Code to connect via stdio while the server handles payments internally
+ */
+import { webcrypto } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { createPaymentClient } from './payment-client.js';
+import { config as loadEnv } from 'dotenv';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// Polyfill crypto for Node.js environment
+if (!globalThis.crypto) {
+    globalThis.crypto = webcrypto;
+}
+loadEnv();
+async function main() {
+    // Parse command line arguments
+    const args = process.argv.slice(2);
+    const urlIndex = args.indexOf('--url');
+    if (urlIndex === -1 || !args[urlIndex + 1]) {
+        console.error('Error: --url argument is required');
+        process.exit(1);
+    }
+    const serverUrl = args[urlIndex + 1];
+    console.error('Creating MCP client with FluxA Wallet Service payment support...');
+    console.error('URL:', serverUrl);
+    // FluxA configuration
+    const fluxaWalletServiceUrl = process.env.FLUXA_WALLET_SERVICE_URL || "https://walletapi.fluxapay.xyz";
+    const evmNetwork = process.env.EVM_NETWORK || "base";
+    // Check for agent registration credentials
+    const agentEmail = process.env.AGENT_EMAIL;
+    const agentName = process.env.AGENT_NAME || "Claude Code - My Agent";
+    const clientInfo = process.env.CLIENT_INFO || "FluxA Connect MCP Client";
+    if (!agentEmail || !agentName) {
+        console.error('Error: AGENT_EMAIL and AGENT_NAME environment variables are required');
+        console.error('');
+        console.error('Example:');
+        console.error('  AGENT_EMAIL=your@email.com');
+        console.error('  AGENT_NAME="Claude Code - agentwallet.fluxapay.xyz"');
+        console.error('  CLIENT_INFO="Claude Code on macOS" (optional)');
+        process.exit(1);
+    }
+    // Register agent with FluxA and get JWT
+    console.error('Registering agent with FluxA...');
+    console.error('Email:', agentEmail);
+    console.error('Agent Name:', agentName);
+    let agentJwt;
+    let agentId;
+    try {
+        const response = await fetch("https://agentid.fluxapay.xyz/register", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                email: agentEmail,
+                agent_name: agentName,
+                client_info: clientInfo,
+            }),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(data.message || "Registration failed");
+        }
+        agentJwt = data.jwt;
+        agentId = data.agent_id;
+        console.error('✓ Agent registered successfully');
+        console.error('Agent ID:', agentId);
+        console.error('JWT obtained');
+    }
+    catch (error) {
+        console.error('✗ Agent registration failed:', error.message);
+        console.error('');
+        console.error('Please check:');
+        console.error('  - Your email and agent name are correct');
+        console.error('  - You have internet connectivity');
+        console.error('  - FluxA registration service is available');
+        process.exit(1);
+    }
+    const url = new URL(serverUrl);
+    // Create transport
+    const transport = new StreamableHTTPClientTransport(url);
+    // Initialize MCP client
+    const client = new Client({ name: 'x402-proxy-client', version: '1.0.0' }, { capabilities: {} });
+    await client.connect(transport);
+    console.error('MCP client connected');
+    // Get preferred network from environment
+    // Wrap client with FluxA X402 payment capabilities
+    const paymentClient = createPaymentClient(client, {
+        fluxaWalletServiceUrl,
+        agentJwt,
+        agentName,
+        network: evmNetwork,
+        confirmationCallback: async (paymentOptions) => {
+            console.error("Payment requested on the following networks:");
+            paymentOptions.forEach(p => {
+                console.error(`- ${p.network}: ${p.maxAmountRequired} (${p.description})`);
+            });
+            console.error(`Using network: ${evmNetwork}`);
+            return true; // Auto-approve (user approves via FluxA UI)
+        }
+    });
+    console.error('Payment client configured with FluxA Wallet Service');
+    // List available tools from upstream
+    const upstreamTools = await paymentClient.listTools();
+    console.error('Available upstream tools:', upstreamTools.tools.map(t => t.name));
+    console.error('Full tool metadata:', JSON.stringify(upstreamTools.tools, null, 2));
+    // Verify inputSchema is present
+    upstreamTools.tools.forEach(tool => {
+        if (tool.inputSchema) {
+            console.error(`Tool ${tool.name} has inputSchema:`, JSON.stringify(tool.inputSchema, null, 2));
+        }
+        else {
+            console.error(`WARNING: Tool ${tool.name} is missing inputSchema!`);
+        }
+    });
+    // Create MCP stdio server
+    const server = new Server({
+        name: 'fluxa-connect-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register handlers using the correct MCP SDK API
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        // Forward tool list from upstream, ensuring all fields are preserved
+        console.error('[STDIO-SERVER] ListTools called, returning tools:', upstreamTools.tools.map(t => ({
+            name: t.name,
+            hasInputSchema: !!t.inputSchema
+        })));
+        return upstreamTools;
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        console.error(`[STDIO-SERVER] Calling tool: ${name}`);
+        console.error(`[STDIO-SERVER] Tool arguments:`, JSON.stringify(args, null, 2));
+        try {
+            // Forward tool call to payment-enabled client
+            console.error(`[STDIO-SERVER] Forwarding to paymentClient.callTool...`);
+            const result = await paymentClient.callTool({
+                name,
+                arguments: args
+            });
+            console.error(`[STDIO-SERVER] Tool ${name} succeeded`);
+            return result;
+        }
+        catch (error) {
+            console.error(`[STDIO-SERVER] Tool ${name} failed:`, error);
+            throw error;
+        }
+    });
+    // Connect server to stdio
+    const stdioTransport = new StdioServerTransport();
+    await server.connect(stdioTransport);
+    console.error('X402 Proxy MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio-server.js.map

package/dist/stdio-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.js","sourceRoot":"","sources":["../stdio-server.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,0CAA0C;AAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,MAAM,GAAG,SAAgB,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,CAAC;AAEV,KAAK,UAAU,IAAI;IACjB,+BAA+B;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAErC,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAClF,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC,sBAAsB;IACtB,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,gCAAgC,CAAC;IACvG,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IAErD,2CAA2C;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,wBAAwB,CAAC;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,0BAA0B,CAAC;IAEzE,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACtF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAExC,IAAI,QAAgB,CAAC;IACrB,IAAI,OAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,UAAU;gBACjB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,UAAU;aACxB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC;QACzD,CAAC;QAED,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAExB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAE/B,mBAAmB;IACnB,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEzD,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACjG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAEtC,yCAAyC;IAEzC,mDAAmD;IACnD,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE;QAChD,qBAAqB;QACrB,QAAQ;QACR,SAAS;QACT,OAAO,EAAE,UAAU;QACnB,oBAAoB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;YAC7C,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC9D,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,CAAC,4CAA4C;QAC3D,CAAC;KACF,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAErE,qCAAqC;IACrC,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnF,gCAAgC;IAChC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACjC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjG,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,kDAAkD;IAClD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,qEAAqE;QACrE,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/F,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;SAChC,CAAC,CAAC,CAAC,CAAC;QACL,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAA2C,CAAC;QAEtF,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,8CAA8C;YAC9C,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC;gBAC1C,IAAI;gBACJ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CAAC,uBAAuB,IAAI,YAAY,CAAC,CAAC;YACvD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAClD,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAErC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@fluxa-pay/fluxa-connect-mcp",
+  "version": "0.1.4",
+  "type": "module",
+  "description": "MCP server with FluxA Wallet Service integration for X402 payments",
+  "bin": {
+    "fluxa-connect-mcp": "dist/stdio-server.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "fluxa",
+    "x402",
+    "payments",
+    "claude",
+    "wallet"
+  ],
+  "author": "FluxA",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FluxA-Agent-Payment/payment-proxy-servers.git",
+    "directory": "cli-ts"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.18.2",
+    "x402-fetch": "^0.7.0",
+    "dotenv": "^16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.6.0"
+  }
+}