Frexplorer MCP Server

An MCP (Model Context Protocol) server for Frexplorer — the Enterprise Wallet Manager API at frexplorer.agenticledger.ai.

Overview

This server provides AI assistants (Claude, etc.) with tools to:

• Query wallet balances across 42+ blockchain chains
• Fetch historical balances at specific blocks/timestamps
• Explore transaction history
• Export transactions as CSV
• Manage organization wallets (with API key)

Supported Chains

EVM Chains: Ethereum, Polygon, Arbitrum, Optimism, Base, BNB, Avalanche, Fantom, zkSync, Linea, Scroll, Blast, Mantle, and more.

Avalanche Ecosystem: 42 L1s including C-Chain, P-Chain, X-Chain, DFK, Beam, Shrapnel, etc.

Non-EVM: Bitcoin, Solana, Cosmos, Cardano, Polkadot, Stellar, Hedera, NEAR, Sui, Canton Network, and more.

Installation

# Clone or copy the mcp-server folder
cd frexplorer-mcp-server

# Install dependencies
npm install

# Build
npm run build

Configuration

Environment Variables

# Required
FREXPLORER_BASE_URL=https://backend-production-2871d.up.railway.app

# Optional (for authenticated routes)
FREXPLORER_API_KEY=your_api_key_here
FREXPLORER_ORG_ID=your_organization_uuid

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "frexplorer": {
      "command": "node",
      "args": ["/path/to/frexplorer-mcp-server/dist/index.js"],
      "env": {
        "FREXPLORER_BASE_URL": "https://backend-production-2871d.up.railway.app"
      }
    }
  }
}

For authenticated access (wallet management):

{
  "mcpServers": {
    "frexplorer": {
      "command": "node",
      "args": ["/path/to/frexplorer-mcp-server/dist/index.js"],
      "env": {
        "FREXPLORER_BASE_URL": "https://backend-production-2871d.up.railway.app",
        "FREXPLORER_API_KEY": "your_api_key",
        "FREXPLORER_ORG_ID": "your_org_uuid"
      }
    }
  }
}

Available Tools

Public Tools (No Auth Required)

| Tool | Description | |------|-------------| | chains_list | List all 42+ supported blockchain chains | | chain_check | Check if a specific chain is supported | | balance_get | Get wallet balance (native + tokens) — supports historical | | block_at_timestamp | Convert timestamp to block number for historical queries | | tx_chains_list | List chains that support transaction explorer | | tx_list | Fetch transaction history for a wallet | | tx_mappings_list | List available CSV export mapping templates | | tx_export | Export transactions as CSV |

Authenticated Tools (API Key Required)

| Tool | Description | |------|-------------| | wallets_list | List organization wallets | | wallet_get | Get wallet details by ID | | wallet_stats | Get organization wallet dashboard stats | | wallet_assets | Get aggregated asset breakdown | | balance_refresh | Trigger balance refresh for a wallet |

Usage Examples

Get Wallet Balance

Use balance_get with address="0x..." and chain="ethereum"

Historical Balance

Use balance_get with address="0x...", chain="ethereum", and block=18500000

Or use timestamp:

First use block_at_timestamp with chain="ethereum" and timestamp=1700000000
Then use balance_get with the returned block number

Transaction History

Use tx_list with address="0x...", chain="ethereum", limit=50

Filter by Date

Use tx_list with address="0x...", chain="polygon", from_date="2024-01-01", to_date="2024-06-30"

Rate Limits

Public endpoints are rate-limited to 10 requests per minute per IP. The API will return 429 if exceeded.

Testing

# Set API URL (required)
export FREXPLORER_BASE_URL=https://backend-production-2871d.up.railway.app

# Run tests
npm test

Project Structure

frexplorer-mcp-server/
├── src/
│   ├── api-client.ts    # HTTP client for Frexplorer API
│   ├── tools.ts         # MCP tool definitions (13 tools)
│   └── index.ts         # Server entry point
├── test/
│   └── test-tools.ts    # Automated test suite
├── docs/
│   └── TEST-RESULTS.md  # Test results
├── dist/                # Compiled JavaScript
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

License

MIT

Author

Ore Phillips (@oregpt)

Links

• Frexplorer — Enterprise Wallet Manager
• AgenticLedger — AI Agent Platform