Based Loans
officialBorrow USDC against Base tokens with no liquidations, or lend USDC. Live quotes, token risk reports, positions and unsigned transactions. No login, never holds keys.
What can you do with Based Loans MCP?
- Borrow against a token — Ask for an exact loan quote and an unsigned borrow plan for a given token, collateral amount, and term.
- Lend USDC — Deposit USDC and choose which tokens to lend against, with a per-token limit.
- Check positions and risk — Retrieve live market data, risk reports, and current positions for a wallet.
- Build unsigned transactions — Get ordered transaction steps to sign and send from the user's own wallet; no keys are held.
- Use the agent skill — Follow borrowing and lending workflows documented in
skills/based-loansandSKILL.md.
Hosted MCP Server
npx add-mcp 'https://mcp.based.loans/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Based Loans for agents
Tools that let AI agents and apps use Based Loans, the no-liquidation lending protocol on Base.
- Borrow: deposit a token, get USDC now, buy the token back at a fixed price before the due date. Price swings never trigger a sale.
- Lend: deposit USDC and choose which tokens to lend against, with a limit per token.
Nothing here holds keys. Everything returns live data or unsigned transactions for the user's own wallet.
| Package | What it is |
|---|---|
@basedloans/sdk | TypeScript SDK (viem). Markets, risk reports, exact loan quotes, positions, unsigned transaction builders. |
@basedloans/mcp | MCP server (stdio and Streamable HTTP) plus a GET API for agents that cannot speak MCP. |
@basedloans/agentkit | Coinbase AgentKit action provider. |
skills/based-loans | Agent skill (SKILL.md) with borrowing and lending workflows. Its main home, with install steps and a Claude Code plugin, is 0xVarius/basedloans-skill. |
plugins/base-mcp | Custom plugin spec for Base MCP. |
integrations/bankr | Bankr skill (SKILL.md + catalog.json) for the BankrBot/skills catalog. |
docs | Collateral types guide and llms.txt. |
Quick start
# MCP server for Claude Desktop, Cursor, etc.
npx -y @basedloans/mcp
import { createBasedLoans } from "@basedloans/sdk"
const bl = createBasedLoans({ rpcUrl: process.env.BASE_RPC_URL })
const quote = await bl.quoteBorrow({ asset: "0x4200000000000000000000000000000000000006", collateralAmount: "0.5", term: "short" })
const plan = await bl.buildBorrow({ asset: quote.asset, collateralAmount: "0.5", term: "short", borrower: "0xYou" })
// plan.steps: sign and send in order with your wallet
Development
nvm use # Node 24
npm install
npm run build
npm run typecheck
node packages/sdk/scripts/e2e-fork.mjs http://127.0.0.1:8545 # against an Anvil fork of Base
node packages/mcp/scripts/smoke.mjs # stdio + HTTP server checks
npm run sync:assets # refresh the token list from the frontend
All protocol parameters (fees, terms, minimums, limits) are read on-chain. Contract addresses are resolved from Core at runtime.