🌐 WAX MCP Server

Let AI agents interact with the WAX blockchain. Query balances, explore NFTs, track prices, and monitor transactions — all through natural language.

The first MCP server for the WAX ecosystem. Built for Claude, Cursor, Cline, and any MCP-compatible AI agent.

✨ What It Can Do

Related MCP server: SEI MCP Server V2

🚀 Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "wax": {
      "command": "uvx",
      "args": ["wax-mcp-server"]
    }
  }
}

With Cursor

cursor --mcp-server wax-mcp-server

Direct Python

# Install
pip install wax-mcp-server

# Run
python -m wax_mcp_server.server

💡 Example Prompts

Once connected, try asking your AI agent:

"What's the WAXP price right now?"

"Show me the top 10 WAX NFT collections"

"Check the balance of account yksanjo.wax"

"What NFTs does account 1.wax own?"

"Show me recent sales from the alienworlds collection"

"Get the market cap and 24h volume for WAXP"

"What transactions has account test.gm done recently?"

🏗️ Architecture

┌─────────────┐     ┌──────────────────┐     ┌──────────────────┐
│  AI Agent   │────▶│  WAX MCP Server  │────▶│  WAX Blockchain  │
│  (Claude,   │     │  (this project)  │     │  (RPC + APIs)    │
│  Cursor...) │     │                  │     │                  │
└─────────────┘     └──────────────────┘     └──────────────────┘
                           │
                    ┌──────┴──────┐
                    │  Data Sources │
                    │              │
                    │ • WAX RPC    │
                    │ • AtomicAssets│
                    │ • CoinGecko  │
                    └─────────────┘

Data Sources Used

• WAX RPC (wax.greymass.com) — Account data, balances, transactions

• AtomicAssets API — NFT assets, collections, marketplace sales

• CoinGecko API — WAXP price and market data

All public APIs — no API keys required.

🛠️ Development

# Clone
git clone https://github.com/yksanjo/wax-mcp-server.git
cd wax-mcp-server

# Install deps
pip install -e .

# Run
python -m wax_mcp_server.server

📦 Published Packages

• GitHub: github.com/yksanjo/wax-mcp-server

• PyPI: Coming soon — pip install wax-mcp-server

🗺️ Roadmap

• WAX Account Creation — Create new WAX accounts via AI

• NFT Minting — Mint NFTs through natural language

• Token Transfers — Send WAXP and tokens

• Alcor DEX Integration — Check swap rates, liquidity pools

• Smart Contract Deployment — Deploy and interact with custom contracts

• Web Dashboard — Visual interface for non-CLI users

🤝 Contributing

PRs welcome! This is the first MCP server for WAX — let's build the ecosystem together.

• Open an Issue

• Submit a PR

• Join the WAX Discord

📄 License

MIT