# robinscan-mcp

MCP server for querying [Robinhood Chain](https://robinscan.io) blockchain data.

## Tools

| Tool | Description |
|---|---|
| `get_chain_stats` | Network statistics: price, gas, blocks, addresses, transactions |
| `get_activity_chart` | 14-day daily transaction volume |
| `lookup_address` | Transaction history for an address |
| `get_address_transfers` | ERC-20/721/1155 token transfers for an address |
| `get_transaction_logs` | Decoded event logs for a transaction |
| `get_token_counters` | Total transfer count for a token contract |
| `get_token_transfers` | Transfers of a specific token |
| `get_stock_price` | Tokenized stock price and historical bars |
| `get_latest_blocks` | 12 most recent blocks with transactions |

## Setup

```bash
npm install
npm run build
```

## Usage

Any MCP-compatible client can connect to this server. Below are examples for common clients.

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "robinscan": {
      "command": "node",
      "args": ["/path/to/robinscan-mcp/dist/index.js"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add robinscan node /path/to/robinscan-mcp/dist/index.js
```

### Cursor / Windsurf / Zed

Add to your MCP config:

```json
{
  "mcpServers": {
    "robinscan": {
      "command": "node",
      "args": ["/path/to/robinscan-mcp/dist/index.js"]
    }
  }
}
```

### Custom Integration

The server communicates over stdio using the MCP protocol. Start it:

```bash
node dist/index.js
```

Then send JSON-RPC messages to stdin.

## Configuration

Set the API URL (defaults to `https://robinscan.io`):

```bash
export ROBINSCAN_API_URL=https://robinscan.io
```

## License

MIT