Based Loans
● Activeio.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.
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"
]
}
}
}claude mcp add basedloans -- npx -y @basedloans/mcp@0.1.3codex mcp add basedloans -- npx -y @basedloans/mcp@0.1.3code --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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks 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 →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_infoLive 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.
- list_markets1 param
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 parametersHide 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 parametersHide parameters
assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
get_risk_report2 paramsLive 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 parametersHide parameters
assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALBskip_depthbooleanSkip the pool depth calculation (faster)
quote_borrow4 paramsExact 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 parametersHide parameters
assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALBcollateral_amountstringrequiredCollateral to offer, in token units, e.g. 0.5loan_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 paramStatus, collateral, buyback cost and remaining amount, due date and lenders for one loan.
Show parametersHide parameters
loan_idrequiredLoan ID
get_borrower_loans1 paramEvery loan a wallet has opened, with status (active, partially_repaid, repaid, defaulted), buyback remaining and time until due.
Show parametersHide parameters
borrowerstringrequiredBorrower wallet address on Base
get_lender_position1 paramA 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 parametersHide parameters
lenderstringrequiredLender wallet address on Base
request_token_listing1 paramCheck 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 parametersHide parameters
tokenstringrequiredToken contract address on Base
explain_collateral_typesHow 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 paramsReturns 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 parametersHide parameters
assetstringrequiredToken contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALBcollateral_amountstringrequiredCollateral to offer, in token units, e.g. 0.5. It is a maximum: only what the loan needs is takenloan_amount_usdcstringLoan amount before the fee, in USDC. Omit to borrow the most the collateral allowstermrequiredLoan 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 balancesmax_shortfall_bpsintegerMax gap between requested and funded amount in basis points. Omit for the protocol default.
build_buyback3 paramsReturns 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 parametersHide parameters
loan_idrequiredLoan IDpayment_usdcstringUSDC to pay. Omit to pay everything left and get all collateral backborrowerstringrequiredBorrower wallet that will sign; must be the wallet that opened the loan
build_deposit3 paramsReturns 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 parametersHide parameters
amount_usdcstringrequiredUSDC to deposit, e.g. 500lenderstringrequiredLender wallet that will sign; used to skip unneeded approvals and check balanceslimitsarrayPer-token lending limits to set in the same transaction. A first deposit needs at least one to be lent
build_set_limits2 paramsReturns 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 parametersHide parameters
limitsarrayrequiredTokens and the max USDC to lend against eachlenderstringrequiredLender wallet that will sign
build_withdraw3 paramsReturns 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 parametersHide parameters
amount_usdcrequiredUSDC to withdraw, or "max" for everything not in active loanslenderstringrequiredLender wallet that will signas_musdcbooleanReceive mUSDC vault shares instead of USDC, skipping the 0.25% withdrawal fee
build_claim_proceeds2 paramsReturns 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 parametersHide 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 paramReturns the unsigned transaction for a lender to claim their share of collateral from loans that passed their due date without a full buyback.
Show parametersHide parameters
loan_idsarrayrequiredIDs of past-due loans you funded, from get_lender_position (1 to 50)
build_set_auto_redeploy1 paramReturns the unsigned transaction to turn automatic re-lending of repaid principal on or off.
Show parametersHide parameters
enabledbooleanrequiredtrue to re-lend repaid principal automatically, false to keep it available to withdraw
simulate_transaction4 paramsDry-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 parametersHide parameters
tostringrequiredThe step's to address, as returned by a build_ tooldatastringrequiredThe step's calldata, as returned by a build_ toolvaluestringNative value in wei. Always 0 for Based Loans callsfromstringrequiredWallet 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-http
https://mcp.based.loans/mcp
Alternatives to Based Loans
All Based Loans alternatives →Best Finance servers →The most-starred Finance servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| CCXT | 44,949 | Nov 2026 | Local / not checked |
| QR Rápido | 7,477 | Nov 2026 | Needs sign-in |
| Finance Toolkit | 5,554 | Nov 2026 | Needs sign-in |
| AKQuant | 2,627 | Nov 2026 | Local / not checked |
| com.stripe MCP | 2,072 | Nov 2026 | Needs 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.
More Finance servers
Browse all Finance →Appeal Draft – Twin Cities property tax appeal
2016judea
Is my Twin Cities property tax assessment too high? County value vs. recorded sales, when to appeal
twentyone million
21-million-wall
Read the wall and claim one $1 USDC square on Base. No utility, not a token or investment.
Silk
21J3phy
Message other people's AI agents with consent: end-to-end encrypted, on a public ledger.
Hexadata Tools
4robot
15 deterministic validation tools for AI agents: tax IDs (15 countries), VAT, IBAN, LEI, HS codes.
MCP Server Kalshi
9crusher
MCP server for end-to-end trading on Kalshi prediction markets: discover, research, trade.
Finch Agent Catalog
a0971025732-netizen
Free: OFAC check, ATS keywords, FOMC/CPI dates, US yields, HL perps, SG stamp duty, Finch agents
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-0xvarius-basedloans) [](https://serverdex.io/install/vscode/io-github-0xvarius-basedloans) [](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).