MCP tools

The seven tools hoodpocket exposes to the agent. There is intentionally no tool that returns the private key and no tool that sends funds to an external address.

search_tokens

Search tokens by name or symbol via the chain explorer.

Param	Type	Description
query	string	Name or symbol, e.g. CASHCAT, AAPL

Returns up to 15 candidates with address, holders, and price feed status. Names are fakeable; always follow up with get_token_info before trading.

get_token_info

Classify a token address into a trust tier.

Param	Type	Description
address	string	Token contract address

Returns symbol, name, decimals, tier with reasons, holders, price, live pools per quote currency, and the policy that applies to the tier.

quote

Executable price for a swap (exact input, best live pool).

Param	Type	Description
token_in	string	ETH, USDG, or a token address
token_out	string	ETH, USDG, or a token address
amount_in	string	Human-readable amount, e.g. 0.05

One side must be ETH or USDG. Returns expected output, USD value, and the pool used.

swap

Execute a swap through the Uniswap v4 Universal Router. Guardrails run first; a blocked trade costs nothing.

Param	Type	Description
token_in	string	ETH, USDG, or a token address
token_out	string	ETH, USDG, or a token address
amount_in	string	Human-readable amount to sell
slippage_bps	number, optional	Max slippage vs quote, default 100 (1%)

Returns amounts sold and received (gas-corrected for native ETH), USD value, tier, and an explorer link.

get_portfolio

Balances: ETH with live USD value, USDG, and previously traded tokens. If the wallet is unfunded it says so and includes the funding address.

No parameters.

get_limits

Current policy: per-tier rules, the rolling 24h budget, and how much of it is used.

No parameters.

get_trade_history

Recent trades, newest first, with USD values, tiers, and explorer links.

Param	Type	Description
limit	number, optional	Max entries, default 20