Based Loans

● Active

io.github.0xVarius/basedloans

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

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "basedloans": {
      "command": "npx",
      "args": [
        "-y",
        "@basedloans/mcp@0.1.3"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add basedloans -- npx -y @basedloans/mcp@0.1.3
OpenAI Codex CLI
codex mcp add basedloans -- npx -y @basedloans/mcp@0.1.3
VS Code
code --add-mcp '{"name":"basedloans","type":"stdio","command":"npx","args":["-y","@basedloans/mcp@0.1.3"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Finance
Version
0.1.4
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Based Loans is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 6 days ago (Nov 16, 2026), 0 open issues.
Official registry
Active
Published as io.github.0xVarius/basedloans in the official MCP registry, version 0.1.4.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 1 forks.
Runs
Local package or hosted
Ships as a local package (npm) that runs on your machine, and as a hosted endpoint at mcp.based.loans that receives what your client sends it.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 02:09 UTCStatus history & uptime →
● Working165 msprotocol 2025-06-18v0.1.2tools

The endpoint answered the MCP handshake as "Based Loans" and listed 19 tools. Answering since Nov 17, 2026.

Context cost ≈ 4.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 19 tools.

Tools (19)

  • get_protocol_info

    Live protocol parameters: loan fee, the three loan terms with their durations and buyback costs, minimum loan and deposit sizes, per-token lending limit bounds, and whether the protocol is paused.

  • Every token currently accepted as collateral, with price, max loan-to-value, USDC available to borrow against it, active loans, and how it is priced. Set only_with_funds to see only tokens lenders are currently backing.

    Show parameters
    • only_with_fundsbooleanOnly tokens with USDC available to borrow right now
  • get_market1 param

    Price, max loan-to-value, USDC available to borrow, active loans and pricing type for one token.

    Show parameters
    • assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
  • get_risk_report2 params

    Live risk data for lending against (or borrowing with) a token: how many price sources it has and whether they cross-check each other, how far back its pool price history goes, how much trading it would take to move its pool price 2x and 10x, USDC available to borrow against it, its active loan limit, and plain-language explanations of every flag. Use this before setting a lending limit on a token.

    Show parameters
    • assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
    • skip_depthbooleanSkip the pool depth calculation (faster)
  • quote_borrow4 params

    Exact loan quote using the same math the contract runs: USDC you receive after the fee, buyback cost, due date, and how much collateral is used. It replays the lender queue, so the funded amount matches what the loan would really get, and warns (with a suggested amount) when a loan would be funded short.

    Show parameters
    • assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
    • collateral_amountstringrequiredCollateral to offer, in token units, e.g. 0.5
    • loan_amount_usdcstringLoan amount before the fee. Omit to borrow the most the collateral allows.
    • termrequiredLoan term: short, medium or long (or 0/1/2). Durations and costs come from get_protocol_info.
  • get_loan1 param

    Status, collateral, buyback cost and remaining amount, due date and lenders for one loan.

    Show parameters
    • loan_idrequiredLoan ID
  • get_borrower_loans1 param

    Every loan a wallet has opened, with status (active, partially_repaid, repaid, defaulted), buyback remaining and time until due.

    Show parameters
    • borrowerstringrequiredBorrower wallet address on Base
  • get_lender_position1 param

    A lender's deposit, USDC in active loans, USDC available to withdraw, per-token limits, and every loan they funded with any repaid USDC or defaulted collateral they can claim.

    Show parameters
    • lenderstringrequiredLender wallet address on Base
  • request_token_listing1 param

    Check whether a token is accepted as collateral. If it is not, returns a pre-filled link to the Based Loans request form for the user to open and submit. Nothing is submitted automatically.

    Show parameters
    • tokenstringrequiredToken contract address on Base
  • explain_collateral_types

    How Based Loans prices different kinds of collateral (regular tokens, two-hop priced tokens, staked and share tokens, escrowed tokens), with examples, and what each means for borrowers and lenders.

  • build_borrow6 params

    Returns the unsigned transactions to open a loan: an approval (only if needed) then openLoan. Includes the quote and warnings. The user's wallet must sign and send each step in order.

    Show parameters
    • assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
    • collateral_amountstringrequiredCollateral to offer, in token units, e.g. 0.5. It is a maximum: only what the loan needs is taken
    • loan_amount_usdcstringLoan amount before the fee, in USDC. Omit to borrow the most the collateral allows
    • termrequiredLoan term: short, medium or long (or 0/1/2). Durations and costs come from get_protocol_info.
    • borrowerstringrequiredWallet that will sign; used to skip unneeded approvals and check balances
    • max_shortfall_bpsintegerMax gap between requested and funded amount in basis points. Omit for the protocol default.
  • build_buyback3 params

    Returns the unsigned transactions to pay back a loan and get collateral back: a USDC approval (only if needed) then buyback. Omit payment_usdc to pay the full remaining amount.

    Show parameters
    • loan_idrequiredLoan ID
    • payment_usdcstringUSDC to pay. Omit to pay everything left and get all collateral back
    • borrowerstringrequiredBorrower wallet that will sign; must be the wallet that opened the loan
  • build_deposit3 params

    Returns the unsigned transactions to deposit USDC for lending, optionally setting per-token lending limits in the same transaction (needed before a first deposit can be lent). Check get_risk_report for each token first.

    Show parameters
    • amount_usdcstringrequiredUSDC to deposit, e.g. 500
    • lenderstringrequiredLender wallet that will sign; used to skip unneeded approvals and check balances
    • limitsarrayPer-token lending limits to set in the same transaction. A first deposit needs at least one to be lent
  • build_set_limits2 params

    Returns the unsigned transaction to add, change or remove per-token lending limits. A limit cannot be set below what is already in active loans for that token.

    Show parameters
    • limitsarrayrequiredTokens and the max USDC to lend against each
    • lenderstringrequiredLender wallet that will sign
  • build_withdraw3 params

    Returns the unsigned transaction to withdraw USDC that is not in active loans. Use "max" for everything available. as_musdc receives vault shares and skips the 0.25% withdrawal fee.

    Show parameters
    • amount_usdcrequiredUSDC to withdraw, or "max" for everything not in active loans
    • lenderstringrequiredLender wallet that will sign
    • as_musdcbooleanReceive mUSDC vault shares instead of USDC, skipping the 0.25% withdrawal fee
  • build_claim_proceeds2 params

    Returns the unsigned transaction to claim repaid USDC from loans you funded (mode withdraw) or put it straight back into lending (mode redeploy). Get loan IDs from get_lender_position.

    Show parameters
    • loan_idsarrayrequiredIDs of loans you funded, from get_lender_position (1 to 50)
    • modestringwithdraw sends the USDC to your wallet (default); redeploy puts it back into lending
  • build_claim_collateral1 param

    Returns the unsigned transaction for a lender to claim their share of collateral from loans that passed their due date without a full buyback.

    Show parameters
    • loan_idsarrayrequiredIDs of past-due loans you funded, from get_lender_position (1 to 50)
  • build_set_auto_redeploy1 param

    Returns the unsigned transaction to turn automatic re-lending of repaid principal on or off.

    Show parameters
    • enabledbooleanrequiredtrue to re-lend repaid principal automatically, false to keep it available to withdraw
  • simulate_transaction4 params

    Dry-runs one prepared transaction from a wallet against the latest block and explains the failure in plain language if it would revert. Steps that depend on an earlier approval only pass after that approval is mined.

    Show parameters
    • tostringrequiredThe step's to address, as returned by a build_ tool
    • datastringrequiredThe step's calldata, as returned by a build_ tool
    • valuestringNative value in wei. Always 0 for Based Loans calls
    • fromstringrequiredWallet that would send the transaction

Checked by Serverdex with a plain initialize + tools/list call to mcp.based.loans/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 16, 2026
Stars
0
Forks
1
Last push
Nov 16, 2026
License
MIT

TypeScriptagentkitai-agentsbasedefilendingmcpmcp-servertypescriptviem

From the README

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. Quick start Development All protocol parameters (fees, terms, minimums, limits) are read on-chain. Contract addresses are resolved from Core at runtime.

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.based.loans/mcp

The most-starred Finance servers in the index, with their live-check result.

ServerStarsLast pushLive check
CCXT44,949Nov 2026Local / not checked
QR Rápido7,477Nov 2026Needs sign-in
Finance Toolkit5,554Nov 2026Needs sign-in
AKQuant2,627Nov 2026Local / not checked
com.stripe MCP2,072Nov 2026Needs sign-in

Based Loans: questions people ask

Is Based Loans a remote or a local MCP server?
According to its entry in the official MCP registry, Based Loans ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (npm) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does Based Loans need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Based Loans safe to use?
Looks healthy: Based Loans is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Based Loans still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 16, 2026.
What tools does Based Loans expose?
19 tools as listed by the server itself during the live check, including get_protocol_info, list_markets, get_market, get_risk_report, quote_borrow. The full list with parameters is in the Live check section above.
How do I add Based Loans to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Finance →

Add the badge to your site

Show visitors that Based Loans is listed here — it’s also the link we check for a free listing.

Based Loans — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-0xvarius-basedloans?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Based Loans — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Based Loans — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-0xvarius-basedloans?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-0xvarius-basedloans) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-0xvarius-basedloans) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-0xvarius-basedloans)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-0xvarius-basedloans"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-0xvarius-basedloans"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-0xvarius-basedloans"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).