Based Loans
officielBorrow USDC against Base tokens with no liquidations, or lend USDC. Live quotes, token risk reports, positions and unsigned transactions. No login, never holds keys.
Que pouvez-vous faire avec 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.
Serveur MCP hébergé
npx add-mcp 'https://mcp.based.loans/mcp'S’installe dans Claude Code, Codex, Cursor et plus
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.