# Hevium: Multi-Chain Autonomous Trading Protocol & MCP (Elysium, Base, Solana, Robinhood)

> Hevium (https://hevium.xyz) is the premier multichain launchpad and DEX terminal across Elysium, Base, Solana, and Robinhood.

## For AI Agents, LLMs, and Developers

Hevium provides an official **Model Context Protocol (MCP)** server enabling any AI agent (Claude, Cursor, Antigravity, ElizaOS, AutoGPT, or custom Python/TypeScript bots) to autonomously query live tokens, calculate price quotes, and execute on-chain trades without browser UI intervention.

- **MCP Package**: `@hevium/mcp-server`
- **Execution Command**: `npx @hevium/mcp-server`
- **GitHub Repository**: https://github.com/aimaneth/hevium
- **Full API Documentation**: https://hevium.xyz/llms-full.txt
- **Website & Terminal**: https://hevium.xyz

---

## On-Chain Network & Contract Addresses

- **Network**: Robinhood Chain Mainnet
- **Chain ID**: `4663` (0x1237)
- **Native Currency**: ETH (18 decimals)
- **JSON-RPC Endpoint**: `https://rpc.mainnet.chain.robinhood.com`
- **Block Explorer**: `https://robinhoodchain.blockscout.com`
- **HeviumSwapRouter**: `0x548D1ffE1BD2F5E0c97589E62261320B5B092E10`
- **HeviumV2Factory**: `0xAe332849022A8B71cc4e1A0F9c5a61172c7aE5EB`
- **Treasury**: `0x3eF368806fa91e16C2775A155a937C0Da81F0Bc2`
- **WETH Address**: `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73`
- **USDG (Global Dollar)**: `0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`
- **NVDA (Synthetics)**: `0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC`
- **TSLA (Synthetics)**: `0x322F0929c4625eD5bAd873c95208D54E1c003b2d`

---

## Available MCP Tools for AI Agents

1. `hevium_get_agent_balance`: Checks autonomous agent wallet address, ETH balance, USDG/WETH holdings, and 24h budget.
2. `hevium_get_trending_tokens`: Returns trending launchpad tokens sorted by volume, market cap, and bonding progress.
3. `hevium_get_token_info`: Inspects real-time bonding progress (0-100%), reserve quote balance, and graduation state.
4. `hevium_get_quote`: Simulates expected token output, price impact, and minimum output for slippage protection.
5. `hevium_buy_token`: Autonomously executes a live buy on bonding curve or graduated Uniswap V2 pair.
6. `hevium_sell_token`: Autonomously executes a live sell back to ETH or quote asset with automated ERC-20 approval.

---

## Connecting Claude Desktop

Add this to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hevium": {
      "command": "npx",
      "args": ["-y", "@hevium/mcp-server"],
      "env": {
        "ROBINHOOD_RPC_URL": "https://rpc.mainnet.chain.robinhood.com",
        "HEVIUM_AGENT_PRIVATE_KEY": "0xYOUR_AGENT_PRIVATE_KEY",
        "HEVIUM_MAX_TRADE_ETH": "0.05",
        "HEVIUM_DAILY_BUDGET_ETH": "0.5"
      }
    }
  }
}
```

---

## Safe Execution Guardrails

- Hard Per-Trade Spend Cap (`HEVIUM_MAX_TRADE_ETH=0.05`)
- Rolling 24-Hour Budget (`HEVIUM_DAILY_BUDGET_ETH=0.5`)
- Anti-Spam Floor (`HEVIUM_MIN_TRADE_ETH=0.0005`)
- Slippage Protection (`HEVIUM_MAX_SLIPPAGE_PCT=2.0`)