# Robinhood Chain EVM Web3 MCP Server

A zero-dependency, pure Python **Model Context Protocol (MCP)** server specifically tailored for **Robinhood Chain** (and general Arbitrum Orbit Layer-2 networks). 

This server acts as a Web3/EVM bridge, allowing local AI agents (e.g., Claude, Cursor, Gemini CLI) to read states, estimate gas, simulate execution, and sign/broadcast transactions directly on-chain using simple JSON-RPC tools.

> [!IMPORTANT]
> **Earn 50,000 $ROBIN_MCP instantly upon Pull Request merge!**  
> We run automated bounty distributions for developers and AI agents resolving open issues in our backlog. Check out [CONTRIBUTING.md](file:///data/data/com.termux/files/home/robinhood-evm-mcp/CONTRIBUTING.md) to claim your first bounty!

---

## Why This Matters 
Traditional developers entering a newly launched blockchain (like Robinhood Chain, launched July 2026) face significant friction:
1. **Context Window Bloat:** Passing complex, multi-thousand-line JSON ABIs to an LLM wastes tokens and causes memory degradation.
2. **AI-to-Web3 Gap:** AI models cannot natively compute gas, sign transactions, or verify contract logic without extensive boilerplate code.

This tool solves both:
- **Simplified Signatures:** Uses a local SQLite cache to store complex ABIs, exposing only human-readable, minimal signatures (e.g., `transfer(address,uint256)`) to the LLM.
- **Autonomous Execution:** Allows the agent to query, simulate (dry-run), sign, and verify transactions autonomously when a private key is provided in the environment variables.

---

## 🚀 Pitching for the $1M Arbitrum Open House Developer Grants
Robinhood Chain has committed **$1 Million** to support developer activity and ecosystem growth via the **Arbitrum Open House Program**. 

You can use this codebase to pitch for developer grants:
1. **Fork/Launch this server** as a standalone open-source developer tool.
2. **Build a demo dApp/agent** (e.g., a "Robinhood RWA Portfolio Manager Agent" that dynamically swaps USDG stablecoin yield into tokenized stocks like AAPL/TSLA).
3. **Submit to the Arbitrum / Robinhood Testnet Faucet and Open House program** as an active infrastructure contribution.

---

## 🛠️ Setup Instructions (Termux / Linux)

### 1. Install Dependencies
```bash
pip install -r requirements.txt
```

### 2. Configure Environment variables
Create or update your `~/.env` file:
```env
# RPC Override (Default is Robinhood Mainnet)
ROBINHOOD_CHAIN_RPC_URL="https://rpc.mainnet.chain.robinhood.com"

# Private key for autonomous transaction signing (Keep this secure!)
ROBINHOOD_CHAIN_PRIVATE_KEY="0x..."
```

---

## 🔌 Connecting to AI Clients (MCP Setup)

### 1. Cursor
Go to **Settings > Models > MCP** and add a new server:
- **Name:** `Robinhood-EVM-MCP`
- **Type:** `command`
- **Command:** `python mcp_server.py` (or full path to `mcp_server.py`)

### 2. Claude Desktop
Add this to your `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "robinhood-evm-mcp": {
      "command": "python",
      "args": ["/path/to/robinhood-evm-mcp/mcp_server.py"]
    }
  }
}
```

---

## 🛠️ Exposed MCP Tools

1. **`get_evm_balance(address, token_address)`**: Fetches native ETH or ERC-20 token balance. Supports ticker overrides (`USDG`, `AAPL`, `TSLA` or dynamically registered tickers).
2. **`query_smart_contract(contract_address, function_name, args, abi_type)`**: Executes a read-only query (call) on a smart contract.
3. **`simulate_evm_transaction(contract_address, function_name, args, value_wei)`**: Dry-runs a state-changing transaction and returns estimated gas details.
4. **`send_evm_transaction(contract_address, function_name, args, value_wei, wait_confirm)`**: Builds, signs, and broadcasts a transaction.
5. **`get_robinhood_ticker(ticker)`**: Retrieves the verified contract address of a tokenized stock or USDG.
6. **`switch_rpc_network(network_name)`**: Changes the active network configuration dynamically (options: `robinhood-mainnet`, `robinhood-testnet`, `localhost`).
7. **`register_custom_abi(contract_address, abi_json)`**: Saves custom smart contract ABIs to the local SQLite database mapping.
8. **`scan_launched_tokens(force_refresh)`**: Queries the MemeFactory smart contract on-chain to scan and index all deployed meme tokens.
9. **`import_custom_token(ticker, address, name, decimals)`**: Dynamically imports custom addresses as tickers, saving them to local SQLite cache.
10. **`estimate_meme_trade_output(token_address, trade_type, amount)`**: Simulates a bonding curve trade and computes expected output amount and price impact.
11. **`buy_meme_coin(token_address, eth_amount, max_slippage, min_output_amount)`**: Performs a buy transaction with on-chain bonding curve parameters verified pre-flight for slippage safety.
12. **`sell_meme_coin(token_address, token_amount, max_slippage, min_output_amount)`**: Performs a sell transaction with on-chain bonding curve parameters verified pre-flight for slippage safety.
13. **`execute_cross_chain_bridge(src_chain_id, src_token, dest_chain_id, dest_token, amount_raw, recipient)`**: Fetches cross-chain swap routing and transaction details, then builds, signs, and executes the bridging transaction directly on the source EVM chain.
14. **`get_meme_price_chart(token_address, block_range)`**: Scans chronological buy/sell event logs on-chain and queries current pool reserves to reconstruct historical OHLC chart simulation data for any meme token.

---

## 🏆 Active Developer Bounties

We run a continuous, programmatic payout loop for contributing developers and AI agents:
- **Bounty Reward**: **50,000 $ROBIN_MCP** per merged PR.
- **How to claim**: Resolve any of the open issues in the backlog (e.g., Pyth oracles integration, Staking contracts, Telegram Mini-App), submit a Pull Request, and include your payout wallet address in the PR description formatted as: `Wallet: 0xYourEVMWalletAddress`. The treasury bot automatically transfers tokens upon merge.
- **Start Here**: Check out the [Contributing Guide](CONTRIBUTING.md) for setup instructions.