# Ratehopper

> Ratehopper is a DeFi automation protocol on Base for self-repaying,
> leveraged LP and borrow-position management. AI agents can integrate via
> the Ratehopper MCP server, Virtuals ACP, or the REST API.

## Agent integrations

- [Agents overview](https://ratehopper.ai/agents): human- and agent-readable
  index of how AI agents can integrate with Ratehopper
- Ratehopper MCP server: https://base.mcp.ratehopper.ai/mcp - add directly to
  any MCP client (e.g. Claude Desktop) alongside Coinbase's base-mcp
  (https://mcp.base.org), which prompts the user to connect their wallet in
  the Base app (base.app) and handles signing. No API key required.
- Virtuals ACP: https://acp.ratehopper.ai - registered ACP service provider.
  Currently offers LP-only (CASH_LP) position creation, no borrow leg yet.
  No API key required.
- REST API: backs both integrations above. Requires an x-api-key header;
  request one by emailing support@ratehopper.ai. Two partner surfaces:
  /api/base-mcp (setup, progress callbacks, and read-back by setup request
  or by Safe: logs, portfolio, performance, close) and /api/virtuals-acp
  (setup, progress callbacks, logs, portfolio). Interactive schema at
  /api/docs.

## Integration guide

- [For AI Agents](https://docs.ratehopper.ai/integrations/for-ai-agents):
  full endpoint reference, the MCP tool list, and the two rules that trip
  integrations up - (1) a 404 from a read-back route right after setup means
  "not yet", not "wrong": poll GET /setup-requests/:id until an agentId
  appears, then read; (2) setup records intent only - Ratehopper creates
  position records after confirming on-chain evidence itself, so a partner
  reporting "confirmed" does not by itself make an agent exist. All writes
  are idempotent, so retries are safe.

## Products reachable via these integrations

- Self Repay Agent: borrows against collateral into a liquidity position and
  repays the loan with the trading fees. Carries debt.
- Yield Agent (cash_lp): the user's own USDC into a managed
  concentrated-liquidity position. No borrowing, no liquidation risk. Also
  self-serve at https://ratehopper.ai/earn
- Both: re-checked hourly, moved out of the pool when risk signals turn
  against the position and back in once conditions settle. A position whose
  price has left its band is HELD, not sold - it simply earns no fees until
  the price returns or the signal moves it.