Based Loans

officiel

Borrow 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-loans and SKILL.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.

PackageWhat it is
@basedloans/sdkTypeScript SDK (viem). Markets, risk reports, exact loan quotes, positions, unsigned transaction builders.
@basedloans/mcpMCP server (stdio and Streamable HTTP) plus a GET API for agents that cannot speak MCP.
@basedloans/agentkitCoinbase AgentKit action provider.
skills/based-loansAgent 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-mcpCustom plugin spec for Base MCP.
integrations/bankrBankr skill (SKILL.md + catalog.json) for the BankrBot/skills catalog.
docsCollateral 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.