FluxA-Agent-Payment/FluxA-AI-Wallet-MCP

FluxA AI Wallet MCP

MCP server for FluxA AI Wallet with x402 (EIP-3009 exact) payment support.

Packages

This repository contains two packages:

| Package | Description | Install | |---------|-------------|---------| | @fluxa-pay/fluxa-wallet-mcp | MCP server for AI agent frameworks (Claude Desktop, etc.) | npm install @fluxa-pay/fluxa-wallet-mcp | | @fluxa-pay/fluxa-wallet | Standalone CLI for scripts and automation | npm install -g @fluxa-pay/fluxa-wallet |

Overview

This MCP server enables AI agents to make x402 payments using the FluxA Wallet API. It provides a simple interface for agents to register, authenticate, and execute blockchain payments without managing private keys locally.

Features

• Agent ID Management: Register and manage FluxA Agent IDs
• x402 Payment Support: Generate EIP-3009 payment authorizations via FluxA Wallet API
• Automatic JWT Refresh: Automatically refreshes expired JWT tokens before payments
• No Local Key Management: All signing is handled by FluxA Wallet (no local private keys)
• Policy Management: Policies are managed remotely by FluxA Wallet
• Environment Variable Support: Configure via env vars or config file

Quick Start

CLI

npm install -g @fluxa-pay/fluxa-wallet
fluxa-wallet status

MCP Server

npm install
npm run build
npm start

Development

npm run dev

Build

# Build MCP server only
npm run build

# Build CLI bundle only
npm run build:wallet

# Build both
npm run build:all

Configuration

The server stores configuration in ~/.fluxa-ai-wallet-mcp/config.json by default.

You can override the data directory:

export FLUXA_DATA_DIR=/path/to/custom/dir

Agent ID Configuration

There are two methods to configure Agent ID via environment variables:

**Method 1: Use existing credentials (highest priorit