Based Loans

السجل الرسمي أخرى

Borrow USDC against Base tokens with no liquidations, or lend USDC. Quotes, risk data, unsigned txs.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http based-loans 'https://mcp.based.loans/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "based-loans": {
            "type": "http",
            "url": "https://mcp.based.loans/mcp"
        }
    }
}
NPM package @basedloans/mcp
Claude Code
claude mcp add based-loans -e 'BASE_RPC_URL=<your base_rpc_url>' -e 'BASEDLOANS_READ_ONLY=<BASEDLOANS_READ_ONLY>' -- npx -y @basedloans/mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "based-loans": {
            "command": "npx",
            "args": [
                "-y",
                "@basedloans/mcp@0.1.1"
            ],
            "env": {
                "BASE_RPC_URL": "<your base_rpc_url>",
                "BASEDLOANS_READ_ONLY": "<BASEDLOANS_READ_ONLY>"
            }
        }
    }
}

متغيرات البيئة

  • BASE_RPC_URL سري Base mainnet RPC URL. Defaults to the public endpoint.
  • BASEDLOANS_READ_ONLY Set to 1 to expose only read tools.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

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.
plugins/base-mcpCustom plugin spec for Base MCP.
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.

الأسئلة الشائعة

ما هو Based Loans؟

Borrow USDC against Base tokens with no liquidations, or lend USDC. Quotes, risk data, unsigned txs.

كيف أثبّت Based Loans؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http based-loans 'https://mcp.based.loans/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Based Loans إلى مفتاح API؟

نعم. يتطلب BASE_RPC_URL، وتضبطها في إعداداته.

هل Based Loans مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Based Loans؟

ينشره 0xVarius. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.