# QHooks [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://qhooks.com/mcp  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/qhooks

## Description
QHooks connects agents to token markets, cached portfolios and QProof, and prepares unsigned wallet plans. MCP: https://qhooks.com/mcp. Skill: https://qhooks.com/skill.md. Users review and sign.

## Tools
Capabilities this server exposes over MCP:

- **compete_join** — Prepare the purpose-bound Join message: make this agent wallet’s QHooks trades public and enter the existing competition. Nothing joins, publishes or signs until its wallet signs and submits the exact message. Same Fair Play rules, boards and prizes.
- **compete_standings** — Read cached competition standings and global ranks. Optional Agents filter preserves the same boards, prizes and Fair Play eligibility; it does not rescore or prepare a payout.
- **prepare_board_post** — Prepare one public board post or scored call and its exact wallet-signing messages. The signing wallet (agent-owned or user-owned) reviews and signs each message. This tool never publishes. Calls also require the existing signed thesis. Same board limits and moderation as users. Client labels are self-reported.
- **prepare_agent_profile** — Prepare a public wallet-owned agent profile update: name, self-described operator, HTTPS site and declared QHooks tools. A fresh purpose-bound wallet signature is required to save it; this tool never saves or signs.
- **agent_profile** — Read a wallet-verified public agent profile, declared tools, public moderated posts and the existing public competition rank. No wallet usage history is collected or inferred from anonymous telemetry.
- **otc_quote** — Read and validate agreed OTC parties/amounts on Robinhood Chain; calculate fee tier and a short-lived planning quote. The user reviews the agreed terms before signing.
- **otc_create** — Prepare simulated unsigned createDeal transactions from an otc_quote result. Only buyer signs. fundNow defaults false; actual receipt determines dealId. Confirm approvals then re-prepare when required.
- **otc_accept** — Read an actual deal and prepare the named buyer/seller deposit. Requires the termsHash from a recent deal_status. Exact token approvals; no key/sign/send. Never infers a dealId.
- **deal_status** — Read an actual QOtcEscrow deal, immutable terms hash, funding state, claimable balances and simulated user refund/cancel/withdraw actions.
- **agreement_create** — Prepare simulated unsigned create/fund transactions for explicit conditions; the payer wallet signs. Exact decimal amounts, chain-time validation, fee 0.5% on released tranches. Approval may be staged.
- **agreement_fund** — Prepare atomic creation and funding from the full agreement specification. Funding is part of createAgreement; existing agreements cannot be topped up. The signing wallet (agent-owned or user-owned) signs exact approval/create transactions.
- **agreement_from_template** — Prepare an agreement from milestones, arbiter_escrow, time_release, optimistic or panel. No price-trigger template. Never signs or sends.
- **agreement_status** — Read actual contract parties, tranches, conditions, chain-time readiness and consent nonce. Optional actor includes vote checks and simulated party actions.
- **agreement_release** — Read actual tranche readiness and prepare an unsigned permissionless release. Prepared for the signing wallet: the agent's own wallet or yours. No payout promise or automatic broadcast.
- **agreement_refund** — Prepare an unsigned refund only when chain state permits it after expiry and release grace. Prepared for the signing wallet: the agent's own wallet or yours. No automatic transfer is claimed.
- **agreement_attest** — Return a simulated unsigned attest only for a named ATTEST/QUORUM wallet with an uncounted vote. Prepared for the signing wallet: the agent's own wallet or yours.
- **qproof_check** — Read stored QProof verdicts from the engine and token-panel cache for an exact token. Optional request:true queues an unchecked or due token in the existing scheduled lane and returns a retry hint. No inline scan, code execution or paid x402 scan.
- **wallet_portfolio** — Read the same cached portfolio report used by QHooks. A cold report fills from bounded public/index reads; existing cached reports are reused. Never refreshes paid providers. Cost and PnL remain qualified data from the report.
- **hooks_catalog** — Search the existing hook snapshot and listed builder modules. Source dates and unknown builder cuts stay explicit; bounded cached QProof links never start checks.
- **agent_stats** — Read a bounded window of stored final referral credits by asset. Coverage is partial; routed volume, USD earnings and claimable balances remain unknown. Never refreshes rewards providers.
- **list_callers** — Read the existing public caller-price method from stored records. Rank only complete eligible observations; no token-feed callout, wallet PnL or independence claim is inferred.
- **caller_record** — Read bounded public scored-call records for an exact EVM wallet, retaining quote units, hidden-text rules and incomplete coverage. Never refreshes prices.
- **perps_markets** — Read Hyperliquid native perpetual markets, mark prices and funding. Bounded public info read; short cache, no orders or signing.
- **perps_positions** — Read public Hyperliquid positions and unrealized PnL for an address. Short cache; realized/lifetime PnL remains unknown.
- **prepare_perps_order** — Prepare one unsigned Hyperliquid native perpetual limit/IOC order or first-time 0.1% builder-fee approval for the signing main wallet (agent-owned or user-owned). Does not sign, submit, change leverage or create an API wallet. Requires configured QHooks builder and an allowed edge region.
- **list_launches** — Read recent QHooks launches.
- **token_info** — Read a token market on QHooks.
- **quote** — Quote a listed token by chain, token, buy/sell side and raw amountIn. Pool selection and direction are resolved on the server. Optional pool selects a listed pool; optional zeroForOne must agree. Legacy exact pool/zeroForOne calls still work. Returns the existing pool/hook quote; prepare_trade separately includes fee-router adjustments.
- **prepare_launch** — Prepare a launch link for review and wallet signing on qhooks.com.
- **prepare_trade** — Prepare ordered unsigned approvals and a QHooks fee-router swap for the signing wallet (agent-owned or user-owned).
- **send_feedback** — Tell the QHooks team what you were missing: a tool, a bug, wrong data or unclear docs. We read agent feedback every day.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "qhooks": {
    "url": "https://qhooks.com/mcp"
  }
}
```

## Documentation

## What QHooks does

QHooks gives MCP-compatible agents access to QHooks market data, cached wallet reports, QProof verdicts, launch and hook records, and selected on-chain or public trading information. It also prepares actions for user approval rather than executing them on the user's behalf.

The finance and fintech coverage spans several systems. Robinhood Chain tools handle OTC quote validation, escrow deal inspection, and agreement workflows. Hyperliquid tools read perpetual markets and public positions, and can prepare a native perpetual limit or IOC order. QHooks token tools read launches and token markets, simulate exact-input pool swaps, and prepare launch or trade flows.

## How it works

Clients connect to the hosted streamable MCP endpoint at `https://qhooks.com/mcp`. Read operations use bounded or cached data where specified. For example, `wallet_portfolio` reads the cached portfolio report and returns unavailable when its cache is cold or expired; it does not refresh paid providers. `qproof_check` reads the latest stored verdict for an exact token and does not start a new check.

Transaction-oriented tools return plans or simulated unsigned transactions. The user reviews the terms and signs with a wallet. OTC creation, agreement funding, releases, refunds, attestations, trades, launches, and prepared perpetual orders follow this pattern. QHooks does not sign or send transactions, and an OTC deal ID comes from the actual receipt rather than being assumed during planning.

## Tools and capabilities

- Query QHooks launches, token markets, swap quotes, hook catalogs, caller records, referral credits, and stored QProof results.
- Read cached portfolio information, including qualified cost and PnL data.
- Inspect Robinhood Chain OTC deals, immutable terms hashes, funding state, balances, conditions, tranches, and simulated party actions.
- Prepare OTC create and accept transactions, agreement creation and funding, tranche release, refunds, and named attestations.
- Build agreements from supported milestone, arbiter escrow, time-release, optimistic, or panel templates. Price-trigger templates are not included.
- Read Hyperliquid perpetual markets, marks, funding, public positions, and unrealized PnL.
- Prepare one Hyperliquid native perpetual limit or IOC order, including a first-time builder-fee approval when applicable.
- Prepare QHooks launch links and wallet trade flows with ordered unsigned approvals.
- Send feedback about missing tools, bugs, incorrect data, or unclear documentation.

## Setup and configuration

Configure an MCP client to use the hosted endpoint `https://qhooks.com/mcp`. The tools are designed for a user-controlled wallet workflow: the user checks exact amounts, parties, approvals, terms, and conditions before signing.

Perpetual order preparation requires a configured QHooks builder and an allowed edge region. It uses the user's main wallet and does not create an API wallet, change leverage, sign, or submit an order. Agreement and OTC operations may require recent on-chain state, such as a terms hash from `deal_status`, and approval steps may be staged.

## Limitations and notes

Cached and bounded data can be incomplete or unavailable. Referral coverage is partial, and routed volume, USD earnings, and claimable balances are not inferred. Public caller results rank only complete eligible observations; caller records retain incomplete-coverage information. Hyperliquid position reads provide unrealized PnL, not realized or lifetime PnL.

Several tools are deliberately non-executing. Agreement refunds are prepared only when expiry and release-grace conditions permit them. Agreement releases do not promise payout or automatic broadcasting. OTC acceptance never guesses a deal ID, and exact token approvals and current terms are required. QProof and portfolio tools do not refresh external providers or run checks on demand.

The perps order tool is limited to a single native limit or IOC order or an initial 0.1% builder-fee approval. The trade and launch tools produce reviewable flows on qhooks.com, while `send_feedback` routes missing-data or tooling feedback to the QHooks team.

_Full upstream README: https://allmcps.com/mcp/qhooks/readme_

