Hookr

Public MCP tools for Uniswap v4 pools, hook analysis, quotes and unsigned transaction preparation.

託管 MCP 伺服器

npx add-mcp 'https://hookr.fun/api/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

Hookr MCP server

Connect an agent to Hookr over MCP: the address, the tools, why a build tool never sends, and the read limits.

On this page

Hookr runs a public MCP server. An agent connects once and can find pools, quote, check a trade and get back calls to sign.

What it is

  • Address: https://hookr.fun/api/mcp
  • Streamable HTTP. No sign-in, no key.
  • One JSON answer per POST. No sessions and no streams.
  • Every tool lists the shape of its answer as outputSchema, and its answer comes as structuredContent in that shape.
  • It reads Robinhood Chain (chain id 4663) through the same code hookr.fun runs, so an agent sees what a person on the site sees.
  • Monad and Arbitrum have their own servers, ten tools each: https://hookr.fun/api/mcp?network=monad and https://hookr.fun/api/mcp?network=arbitrum, each with its own skill file (Monad, Arbitrum).
  • Elysium's server has those ten tools and seven more, at https://hookr.fun/api/mcp?network=elysium with its own skill file (Elysium): docs search, and a pool's trades, chart, depth and LP lock, token prices and the integrator list, read from Elysium itself.

Open that address in a browser and you get a short note, not a page. The server only takes POST, which is what an MCP client sends.

Connect

Claude Code:

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

Or in a project's .mcp.json:

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

Claude Desktop: add a custom connector and paste https://hookr.fun/api/mcp.

Any other MCP client that connects to a remote server: give it the same address.

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

Oak, a free add-on that connects AI assistants to Robinhood Chain apps, has Hookr built in: oakagentkit.org.

To see the tools without a client:

curl -s https://hookr.fun/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The server speaks MCP 2026-07-28, and 2025-11-25, 2025-06-18 and 2025-03-26 for clients that still send initialize.

Tools

Thirty tools only read.

ToolWhat it does
hookr_releaseThe contracts the site trades on: whether they are verified, the block they were read at, their addresses by role and the arbitrage recapture lane; new pools bind another core and new tokens another launcher, under newPools. The lane gives its executor, share and gas cap, and executorPinned, whether that executor is the one Hookr pins for the chain. A hook of your own deploys on ownHookFactory.
hookr_poolsEvery listed pool, or one token's pools by address or symbol (token: "HOOKR"): PoolId, tokens, the price in the quote currency and USD, liquidity, volume over 24 hours and all time, fees and Hook Blocks. sort by liquidity, volume or newest. Paged, up to 50 a page. agentsOnly lists only agents-only pools; pools with a test ticker are left out unless includeTests is true. A pool's blocks.catalogIds are the ids hookr_blocks lists them by.
hookr_poolOne pool as its page reads it: Hook Blocks and their settings, the add-on and its caps, arbitrage recapture, Wallet Cap and King of the Pool. blocksNow gives each Hook Block's line for right now, as the pool page shows it (Guard ends in 2m, Exit fee 0.78% now, 0% in 2d 14h, Round ends in 3h 12m · lead 0.42 ETH); a line about one wallet stays on the page.
hookr_blocksThe Hook Blocks Hookr lists, with what each does, its page and whether it is live now. A row with openToNewPools: false runs on pools already open and a new pool cannot take it; a row with partOf is a switch inside that block. A row with outside is a block another builder wrote, listed once Hookr reviews it, with its contract, settings and, where it charges, what it takes and who is paid.
hookr_hookWhat kind of hook an address is: Hookr's shared root, an own hook someone deployed through Hookr's factory (its owner, opening, the Hook Blocks it allows, the core Hook Blocks a pool on it takes now and those its core closes, whether arbitrage recapture is on), or neither. Its listed pools come with it, and a pool Hookr keeps off its lists is left out.
hookr_scanHookrScan's reading of any hook address on Robinhood Chain: the callbacks its permission bits switch on, whether its source is verified, its fixed-rule findings and score, and its report page. It is a screen, not an audit: cannotSee lists what it never reads, such as running the hook or simulating a trade. A hook read in the last ten minutes answers from memory, and fresh scans are capped at six a minute.
hookr_tradesA listed pool's newest trades, as its Trades tab reads them, with arbitrage recapture legs marked.
hookr_recapturesA listed pool's arbitrage recapture ledger: what was recaptured in each currency and what went to its LPs, King of the Pool's pot, Hookr, What The Hook and trader rebates.
hookr_positionsA wallet's liquidity positions on listed pools, with the tokenId that hookr_build_remove_liquidity and hookr_build_collect_fees take.
hookr_token_pricesUS dollar prices for up to eight tokens that trade in listed pools, each with its source, or unavailable with the reason.
hookr_docsSearches these docs and Learn for a question and answers with the closest sections and their links.
hookr_pool_chartA listed pool's hourly price and volume over 24 hours or 7 days, with the unit each figure is in.
hookr_pool_depthA listed pool's liquidity at each price around its current one, in raw units of its currency0.
hookr_pool_yieldA listed pool's fee APR and what its LPs earned over 24 hours, 7 days and 30 days.
hookr_kings_historyKing of the Pool's past rounds for a listed pool, or a wallet's crowns, prizes and claims.
hookr_lp_lockA listed pool's LP lock: whether it is active, the positions locked in it and, with a wallet, its stakes and what it is owed.
hookr_protocol_statsHookr's totals: traders, launches, trades and volume, the Hook Blocks pools run and each revenue source's share.
hookr_own_hooksThe own hooks deployed through Hookr's factory and its deploy fee, or the hooks a wallet owns.
hookr_wallet_payoutsA wallet's vesting escrows and the payee splits that pay it from Hookr pools.
hookr_integratorsWhether accounts are on the treasury's integrator list for integrator share, at what rate, and any change proposed.
hookr_kingsKing of the Pool's live rounds: who leads, the pot and when the round closes.
hookr_claimsWhat a wallet can claim: prizes, royalties, Holder Pot pay once credited and arbitrage recapture shares held in pools' cores, and its PoolManager claims. A holder's days are credited on its next swap or a poke.
hookr_quoteA quote for a trade through Hookr's quoter, with every Hook Block's take, the burn, the LP fee and the price impact.
hookr_check_tradeWhether a pool's rules let a wallet make a trade. The answer is ok, refused with the reason, or unknown, and unknown is never ok. On an agents-only pool the reason is the Agent gate's own.
hookr_agent_gateA wallet's standing with the Agent gate: whether it passes as an ERC-8004 agent, the agent id it linked, how long the link has stood and its Priors score, or with reviewers its score from any reviewer set registered on the gate. Name an agents-only pool for what the wallet can do there on the gate the pool names, the surcharge and the next step.
hookr_open_ordersThe open limit orders on Hookr's order book, newest first: what each pays and gets at least, its bounty, its expiry and whether it fills now. Paged, up to 5 a page.
hookr_revenue_tokensEvery revenue token, newest first: its tokenizer, creator, supply, streams, Hookr's leg and income over the last 7 days. Paged, up to 50 a page.
hookr_revenue_tokenOne revenue token as its page reads it: streams and when each ends, income per asset, the release period, drops, its market, its price in the market's quote and in USD, its ERC-8004 agent where the agent's record lists it, and holders. Name a wallet for its balance and what it can claim. A token Hookr does not list answers unavailable.
hookr_incomeThe income record of one revenue token (token), one wallet (account) or one ERC-8004 agent (agentId) over the last 1 to 30 days: each payment with its transaction, summed by UTC day and currency in raw units. Pass exactly one of the three. A part that did not read is unavailable and never zero: Income record.
hookr_agent_passOne agent in one read, by agentId, wallet or both: its owner and agent wallet, its link on each Agent gate and how long it has stood, its Priors and Tokyo Futuro scores, whether it can trade agents-only pools and what is missing, its revenue tokens, its income and its path as six steps. It reads, and it also hands back the unsigned calls of the first step that is not met: a link, a first buy, a launch or the revenue token's mint from the build tool that already makes it, and from the pass itself a new agent's registration (a wallet with agentName and agentDescription, sent once, since every send registers a new id) and the public record's link, sent by the id's owner. A built step is ready once simulated from the wallet, or needs_approval where an approval goes first and the step is simulated on the next call; every later step waits on it, and plan: false builds nothing. A part that did not read is unavailable and never zero or an empty list.

Sixteen tools build a call for the wallet to sign.

ToolWhat it builds
hookr_build_swapAn exact-input swap through Hookr's router, with a least output from the quote, a 20-minute deadline and the gas to send it with. Slippage is 50 bps unless you set it.
hookr_build_claimThe claims a wallet can send now, one call per currency.
hookr_build_launchA new token's launch, as the Launch button builds it: one pool on ETH or a reviewed quote such as HOOKR or USDG, named by symbol or address (the tool's quote argument lists them), with the default Hook Blocks and, on Robinhood Chain, the whole supply in the pool from the opening price up. Arbitrage recapture is on unless you pass arbRecapture as false. An outside block from hookr_blocks goes in blocks by its builder- id at its defaults: one with a setting that has no default is refused, and one with a recaptureHold needs arbRecapture false.
hookr_build_revenue_claimA wallet's claim of its income on a revenue token, and of its drops. Pass sync to put the token's sync first.
hookr_build_agent_linkThe link of a wallet to its ERC-8004 agent id on the Agent gate, so its score and its link's age count on agents-only pools, or with unlink the call that removes it. Where the pool's gate asks a wallet with code for a proof, pass proof to build linkWithProof, or sign the digest the tool returns as a message and send link. Name a poolId to link on the gate that pool names: launches bind the second Agent gate, which adds Age to enter; the first, which has none, keeps its four pools.
hookr_build_reviewer_setThe registration of a reviewer set on the Agent gate, for a platform that scores its own agents, with the set id hookr_build_launch takes as agentGateReviewer.
hookr_build_fillThe fill of one open limit order from a wallet, with its gas and what the gas costs. The wallet is credited the order's bounty, and gets the call that claims its bounties when it has some.
hookr_build_limit_orderA limit order on Hookr's order book, as the Limit tab places it, simulated from the wallet; it asks for the book's allowance first on a token input.
hookr_build_cancel_orderThe cancel of one of a wallet's open limit orders, which refunds its input and tip to that wallet.
hookr_build_add_liquidityAn add of liquidity to a pool from your wallet, as the add form builds it: a new position on the Uniswap v4 PositionManager over the range you set in the quote per token (lower and upper, or fullRange), sized from tokenAmount, quoteAmount or both; a range around the price takes both, and with one amount the refusal names the other. It answers needs_approval with the Permit2 approvals to send first, then ok with the mint call. During a pool's launch guard it is refused; on an agents-only pool the Agent gate decides.
hookr_build_remove_liquidityThe removal of a whole percent of a position's liquidity to your wallet, with each amount out floored at the pool's price now less the slippage (50 bps unless you set it). Name tokenId for a PositionManager position (100% burns it) or poolId for your launch's own position, which goes through the Launcher's withdraw once its principal lock has ended. Removing is never gated.
hookr_build_collect_feesThe collection of a position's uncollected fees to your wallet, the principal untouched. Name tokenId for a PositionManager position, or poolId for your launch's own position: that one goes through the Launcher's withdraw with no liquidity, which also moves the pool's arbitrage recapture share into your claims.
hookr_build_tokenizeThe lock of Uniswap v4 positions your wallet holds into a new revenue token, as /tokenize does: the approval for Hookr's position door factory where it is missing, then the mint, one stage per call with the same arguments; the positions stay locked for good unless you set termDays, and only their fees come out, less Hookr's 5% leg on positions off Hookr's hook.
hookr_build_agent_linksThe Agent gate's link for up to 25 agent ids in one call, for a platform that runs many agents: for each id the wallet that signs (the agent's wallet where the agent's public record names one, else its owner) and the unsigned link call, simulated from that wallet. Nothing is sent or relayed: each agent's own wallet or its owner sends its link. A wallet holds one link, so a second id on a wallet an earlier id already uses is refused, and an id already linked answers linked with no call.
hookr_build_chop_logA Chop log for a token opened through Hookr's lock, one stage per call with the same arguments: the token's approval, CHOP's approval, then the open, which wraps the token, pairs it with CHOP, stakes the LP and locks it until the unlock time, a year unless you set unlockDays or pass forever, which never unlocks. After the open, pass its transaction hash as openTx to read the position it locked, never call again without it, since another open opens a second log.
hookr_build_agent_incomeAn ERC-8004 agent's own payments as a revenue token, one stage per call: the agent income door for the token's predicted address, the mint with USDG listed, then the link in the agent's record. Pass the same terms on every call, and pay the door only once doorTakesPayments is true.

Run hookr_check_trade before a trade. Jobs for agents has the jobs the order tools are for.

  • Every quote states priceImpactBps, null when it did not read.
  • At or past 15% price impact, or on a token that is not the official one for its symbol, the answer is refused; an impact that did not read is unknown.
  • hookr_build_swap then builds it only with the acceptImpactBps or acceptToken its accept names, and the call's label says what you accepted; acceptImpactBps is a cap at any impact, so a quote past it is refused.
  • note says when a pool holds no quote currency to pay a seller.

Every revenue token answer names the tokenizer that made the token. A figure that did not read is null and a price unavailable with the reason, never zero.

Open a pool in one call

hookr_build_launch builds a new token's launch on one pool, quoted in ETH or a reviewed quote such as HOOKR or USDG, with the default Hook Blocks and arbitrage recapture on; put your wallet's address in place of 0xYOUR_WALLET:

curl -s https://hookr.fun/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hookr_build_launch","arguments":{"wallet":"0xYOUR_WALLET","name":"Agent Token","symbol":"AGENT"}}}'
  • It answers ok with the launch call for your wallet to sign. When the Launcher needs an allowance first, it answers needs_approval with the approval: send it, then build again with the salt it returned.
  • Arbitrage recapture is on. Pass arbRecapture as false to launch without it: a pool launched without arbitrage recapture never gets it.
  • For an agents-only pool, add agent-gate to blocks. agentGateMinScore, agentGateTierScore, agentGateTierPips, agentGateMinAge, agentGateReviewer and agentGateChecks set its Score to enter, Score for the base fee, surcharge in pips (10000 is 1%), Age to enter (the seconds a wallet's link must have stood before it buys or adds, up to 30 days, one hour unless set, 0 for none), reviewer (priors, or a reviewer set id registered on the gate) and checks (recipient, the default, uniswapRouter, recipient,uniswapRouter for both, or none). Priors scores agents in whole numbers, and a score counts only once the agent links its id on the gate. The score the gate reads can trail the one on Priors until Priors writes it again, at the latest after 30 days. The wallet that launches must be an agent.
  • For a creator tax, pass creatorTaxBps (200 is 2%, from 10 to 1000 in steps of 10): every buy and sell pays it, fixed at launch, and the liquidity owner keeps it less Hookr's share of the pool, 20% at its floor. It is off unless you set it, and only on Robinhood Chain.
  • To earn integrator share on the pool, pass integrator: your account, which must be on the treasury's integrator list. It earns the rate the treasury lists it at, up to half, of Hookr's share of the pool's rule fees and, on Hookr's core, of Hookr's arbitrage recapture cut, frozen when the pool opens. Pass integratorBps to be refused if the list gives another rate.
  • The supply is 1,000,000,000 unless you set supply. On Robinhood Chain the pool takes all of it unless you set tokenSeed; another chain's table asks for tokenSeed. The wallet keeps whatever the pool does not take.
  • On Robinhood Chain, with no lower, upper or fullRange, the pool holds the token alone from the opening price up, so your wallet seeds no quote: buyers bring it. lower and upper, or fullRange, set a range instead, and another chain's table asks for one; quoteSeed puts in the quote side, which a full range needs.
  • Without price, the token opens at a $20,000 market cap at the quote's USD price, as Create sets it; the answer's notes give the price.

Manage your pool's liquidity

Once your pool is open, three tools manage its liquidity for your own wallet, and none of them sends.

  • hookr_build_add_liquidity with poolId, wallet, an amount (tokenAmount, quoteAmount, or both for a range around the price) and a range (lower and upper in the quote per token, or fullRange). The first answer is needs_approval with the Permit2 approvals for an ERC-20 leg; send them and build again for the mint. A native ETH leg goes as the call's value, and what the pool does not take comes back in the same transaction.
  • hookr_build_collect_fees with wallet and either tokenId (a PositionManager position you hold) or poolId (your launch's own position, through the Launcher).
  • hookr_build_remove_liquidity with the same position and percent (default 100). On a PositionManager position 100% burns it; on your launch's position the principal lock has to have ended.

To turn positions into a revenue token, hookr_build_tokenize takes wallet, positions (ids, comma-separated) and termDays, and locks the positions for good when termDays is left out; call it again after each send until it answers done, and send a mint with a term before its sendBefore, about an hour for seven days, or it reverts.

During a pool's launch guard an add is refused with the block it opens at. On an agents-only pool an add is refused in the Agent gate's words unless the wallet passes it; removing is never gated.

Build tools never send

  • The server holds no key. It does not sign and it does not send.
  • A build tool checks the wallet's balance, then simulates the call from that wallet.
  • It returns ok with the call, needs_approval with an approval to send first, or refused or unknown with the reason and no calls.
  • Your wallet signs and sends each call, in the order given.
  • An address may come without its 0x, and an amount as .5 or 1e-3; a form that could mean another value, such as 0.05 ETH or 1,000, is refused with what to send.
  • A list of ids or addresses (positions, agentIds, tokens, accounts, blocks) may come as a JSON list or as one string with commas; an amount is always a string in quotes, never a JSON number.

HOOKR is one address

HOOKR is 0x18E674231A58c239Dc7DaeDcffE15Ec3A24cff5c. Another token with the symbol HOOKR is not HOOKR. Pool results mark each token official or not.

official: false with no copycatOf only means Hookr holds no reference for that token; it is not a warning.

Paid checks

Hookr's two ERC-8004 agents on Robinhood Chain each sell one check over x402. Pool Check costs 0.02 USDG and Pool Watch 0.01 USDG on Robinhood Chain (eip155:4663), x402 version 2, paid to the agent's own wallet and settled by Priors' facilitator. A link answers 402 with the price until a payment comes, and the answer is the read tools' own.

  • Hookr Pool Check, agent 20322: GET https://hookr.fun/api/x402/pool-check?pool=<PoolId>. The pool's frozen Hook Blocks and their settings, arbitrage recapture and caps. Add wallet, side (buy or sell) and amount together for whether that wallet can make the trade, with its price impact.
  • Hookr Pool Watch, agent 20323: GET https://hookr.fun/api/x402/pool-watch. Every pool, the open limit orders with their bounties and the revenue tokens with their income, as they stand now. Add ?pool=<PoolId> for one pool and its orders.

A buyer on the x402 SDK pays only its default assets unless told otherwise. Allow USDG on eip155:4663 in spendControls.allowedAssets first.

Limits

  • Listing the tools does not spend the read budget.
  • Each tool call counts against a read budget for your address: a burst of 24 calls, then one call every 2 seconds.
  • Past the budget the server answers 429 with a Retry-After header that says when to come back.
  • A fast burst can also be turned away at the edge with a plain 429 and no Retry-After, the tool list included. Wait a minute and send it again.
  • The read budget is counted on each server instance the request lands on.
  • A request body can be 64 KB. An answer can be 512 KB; a larger one asks for one pool or a smaller page.
  • A web page on another site cannot call the server from a browser. An agent that sends no Origin can.