# Hookr MCP server

> Read Uniswap v4 pools and hooks, quote trades, and build unsigned swap, liquidity and claim transactions on Hookr.

- Listing: https://mcp.tc/i/hookr
- Connect: use the server's own URL `https://hookr.fun/api/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Finance & Payments](https://mcp.tc/c/finance-payments)
- Vendor: Hookr
- Homepage: <https://hookr.fun/docs/mcp>

## About

Hookr connects to Uniswap v4 pools that run Hook Blocks, mainly on Robinhood Chain. You can list pools, inspect hooks, get quotes, check whether a trade will pass a pool's rules, read King of the Pool rounds, revenue tokens, limit orders and liquidity positions, and scan any hook address.

The server is hosted at a public Streamable HTTP endpoint. No sign-in or API key is needed. It holds no keys and sends nothing: build tools return unsigned calls that the agent's wallet signs and submits. Monad, Arbitrum and Elysium are selected with a network query parameter.

## What it can do

- List and inspect Hookr pools, Hook Blocks and hook addresses
- Quote trades and check whether a wallet's trade will go through
- Build unsigned swaps, limit orders and cancels
- Build unsigned add and remove liquidity and fee collection calls
- Read claims, King of the Pool rounds and build claim calls
- Browse revenue tokens and their income streams
- Scan a Uniswap v4 hook address and search Hookr docs

## Tools (46)

- `hookr_release`: Hookr release details: verification, block, and contract addresses by role. (read-only)
- `hookr_pools`: List listed pools or one token's pools with PoolId and prices. (read-only)
- `hookr_pool`: One pool's tokens, Hook Blocks, settings and caps. (read-only)
- `hookr_blocks`: Hook Blocks Hookr lists and whether each is live. (read-only)
- `hookr_kings`: King of the Pool live rounds, pots and close times. (read-only)
- `hookr_claims`: What a wallet can claim on Hookr. (read-only)
- `hookr_quote`: Quote a trade on a pool with each block's take and fees. (read-only)
- `hookr_check_trade`: Check whether a pool's rules let a wallet make a trade. (read-only)
- `hookr_build_swap`: Build an unsigned exact-input swap call. (read-only)
- `hookr_build_claim`: Build unsigned claim calls for a wallet. (read-only)
- `hookr_build_launch`: Build an unsigned token launch. (read-only)
- `hookr_open_orders`: List open limit orders on the order book. (read-only)
- `hookr_build_fill`: Build an unsigned call that fills a limit order. (read-only)
- `hookr_revenue_tokens`: List revenue tokens made by Hookr's tokenizers. (read-only)
- `hookr_revenue_token`: Details of one revenue token. (read-only)
- `hookr_build_revenue_claim`: Build unsigned calls to claim revenue token income. (read-only)
- `hookr_hook`: Identify what kind of hook an address is. (read-only)
- `hookr_agent_gate`: A wallet's standing with the Agent gate. (read-only)
- `hookr_build_agent_link`: Build a call linking a wallet to its ERC-8004 agent id. (read-only)
- `hookr_build_reviewer_set`: Build a reviewer set registration for the Agent gate. (read-only)
- `hookr_build_add_liquidity`: Build an unsigned add-liquidity call. (read-only)
- `hookr_build_remove_liquidity`: Build an unsigned removal of liquidity. (read-only)
- `hookr_build_collect_fees`: Build an unsigned LP fee collection. (read-only)
- `hookr_scan`: Screen any Uniswap v4 hook address (not an audit). (read-only)
- `hookr_docs`: Search Hookr docs and Learn pages. (read-only)
- `hookr_positions`: A wallet's liquidity positions on listed pools. (read-only)
- `hookr_recaptures`: A pool's arbitrage recapture ledger. (read-only)
- `hookr_trades`: A pool's newest trades. (read-only)
- `hookr_token_prices`: USD prices for up to eight tokens. (read-only)
- `hookr_pool_chart`: Hourly price and volume over 24 hours or 7 days. (read-only)
- `hookr_pool_depth`: Liquidity at each price around the current one. (read-only)
- `hookr_pool_yield`: A pool's LP fee APR and earnings. (read-only)
- `hookr_kings_history`: Past King of the Pool rounds for a pool or wallet. (read-only)
- `hookr_lp_lock`: A pool's LP lock status and locked positions. (read-only)
- `hookr_protocol_stats`: Hookr totals: traders, launches, trades, volume. (read-only)
- `hookr_own_hooks`: Own hooks deployed through Hookr's factory. (read-only)
- `hookr_wallet_payouts`: A wallet's vesting escrows and payee splits. (read-only)
- `hookr_build_limit_order`: Build an unsigned limit order call. (read-only)
- `hookr_build_cancel_order`: Build an unsigned cancel of an open limit order. (read-only)
- `hookr_integrators`: Check whether accounts are on the integrator list. (read-only)
- `hookr_build_tokenize`: Builds, one stage per call, the unsigned calls that lock Uniswap v4 positions a wallet holds and mint a Hookr revenue token on their fees, as /tokenize does, each simulated from the wallet: the approval for Hookr's… (read-only)
- `hookr_income`: The income record of one wallet, one ERC-8004 agent or one revenue token on Robinhood Chain over the last 1 to 30 days: each payment with its transaction, summed by UTC day and currency in raw units, where a part that… (read-only)
- `hookr_agent_pass`: One agent on Robinhood Chain in one read, by agentId, wallet or both: its wallets, its Agent gate links, its Priors and Tokyo Futuro scores, whether it can trade agents-only pools, its revenue tokens, its income, and… (read-only)
- `hookr_build_agent_links`: Builds the Agent gate's link for up to 25 agent ids in one call: for each id the wallet that signs and the unsigned link call simulated from it, where nothing is sent or relayed and a second id on a wallet an earlier… (read-only)
- `hookr_build_agent_income`: Builds, one stage per call, the unsigned calls that turn an ERC-8004 agent's payments into a Hookr revenue token from the agent's own wallet: the agent income door for the token's predicted address, then the mint with… (read-only)
- `hookr_build_chop_log`: Builds, one stage per call, the unsigned calls that open a Chop log for a token through Hookr's lock, each simulated from the wallet: the token's approval to the lock, CHOP's approval, then open, which wraps the token… (read-only)

## Example prompts

- "List the top Hookr pools by volume"
- "Quote buying 100 USDG of HOOKR and check if my wallet can trade"
- "Scan this hook address and tell me which callbacks it runs"
- "What can wallet 0x... claim on Hookr?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http hookr https://hookr.fun/api/mcp
```

2. Start Claude Code and type `/mcp`. **hookr** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **Hookr** and paste this URL:

```url
https://hookr.fun/api/mcp
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Hookr&connectorUrl=https%3A%2F%2Fhookr.fun%2Fapi%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://hookr.fun/api/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://hookr.fun/api/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=hookr&config=eyJ1cmwiOiJodHRwczovL2hvb2tyLmZ1bi9hcGkvbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "hookr": {
      "url": "https://hookr.fun/api/mcp"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=hookr&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhookr.fun%2Fapi%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"hookr","type":"http","url":"https://hookr.fun/api/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "hookr": {
      "type": "http",
      "url": "https://hookr.fun/api/mcp"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "hookr": {
      "serverUrl": "https://hookr.fun/api/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add hookr --url https://hookr.fun/api/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.hookr]
url = "https://hookr.fun/api/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http hookr https://hookr.fun/api/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "hookr": {
      "type": "http",
      "url": "https://hookr.fun/api/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://hookr.fun/api/mcp`.

## Recent changes

- 2026-11-22 08:52 UTC: 3 tools changed. Source: automatic check. Changed: hookr\_agent\_pass, hookr\_build\_chop\_log, hookr\_build\_swap.
- 2026-11-22 02:28 UTC: Tracking started: 46 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/hookr#history (Atom feed: https://mcp.tc/i/hookr/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.5.1
- MCP protocol version: 2026-07-28
- Last checked: 2026-11-21 (reachable)
- Listed: 2026-11-21
- Updated: 2026-11-22

---
Source: https://mcp.tc/i/hookr (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
