# Based Loans (remote · mcp.based.loans)

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

- Trust score: 74/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `mcp.based.loans`: 74/100 (this document), [markdown](https://verifymcp.io/servers/0xvarius-basedloans/mcp.md), [page](https://verifymcp.io/servers/0xvarius-basedloans/mcp)
- npm · `@basedloans/mcp`: 66/100, [markdown](https://verifymcp.io/servers/0xvarius-basedloans/basedloans-mcp.md), [page](https://verifymcp.io/servers/0xvarius-basedloans/basedloans-mcp)

## Channel facts

- Endpoint: `https://mcp.based.loans/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.4`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 75/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2059 tokens (~108/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "build_withdraw" implies "withdraw" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Based Loans MCP server?

Based Loans is a hosted endpoint at https://mcp.based.loans/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http 0xvarius-basedloans 'https://mcp.based.loans/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "0xvarius-basedloans": {
      "url": "https://mcp.based.loans/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "0xvarius-basedloans": {
      "type": "http",
      "url": "https://mcp.based.loans/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.0xvarius-basedloans]
url = "https://mcp.based.loans/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "0xvarius-basedloans": {
      "type": "remote",
      "url": "https://mcp.based.loans/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add 0xvarius-basedloans --url 'https://mcp.based.loans/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  0xvarius-basedloans:
    url: "https://mcp.based.loans/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "0xvarius-basedloans": {
      "Transport": "http",
      "Url": "https://mcp.based.loans/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add 0xvarius-basedloans -t streamable-http -u 'https://mcp.based.loans/mcp'
```

### Other

```json
{
  "mcpServers": {
    "0xvarius-basedloans": {
      "type": "http",
      "url": "https://mcp.based.loans/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-18 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 72, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-16 (score 72)

First indexed and scored.

## MCP tools (19)

### `get_protocol_info` (~47 tokens)

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.

### `list_markets` (~75 tokens)

List collateral tokens

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.

Input parameters:

- `only_with_funds` (boolean): Only tokens with USDC available to borrow right now

### `get_market` (~61 tokens)

Get one collateral token

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

Input parameters:

- `asset` (string, required): Token contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB

### `get_risk_report` (~145 tokens)

Token risk report

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.

Input parameters:

- `asset` (string, required): Token contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
- `skip_depth` (boolean): Skip the pool depth calculation (faster)

### `quote_borrow` (~188 tokens)

Quote a loan

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.

Input parameters:

- `asset` (string, required): Token contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
- `collateral_amount` (string, required): Collateral to offer, in token units, e.g. 0.5
- `loan_amount_usdc` (string): Loan amount before the fee. Omit to borrow the most the collateral allows.
- `term` (required): Loan term: short, medium or long (or 0/1/2). Durations and costs come from get_protocol_info.

### `get_loan` (~36 tokens)

Get a loan

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

Input parameters:

- `loan_id` (required): Loan ID

### `get_borrower_loans` (~55 tokens)

Borrower's loans

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

Input parameters:

- `borrower` (string, required): Borrower wallet address on Base

### `get_lender_position` (~63 tokens)

Lender position

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.

Input parameters:

- `lender` (string, required): Lender wallet address on Base

### `request_token_listing` (~59 tokens)

Request a new token

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.

Input parameters:

- `token` (string, required): Token contract address on Base

### `explain_collateral_types` (~49 tokens)

Collateral types explained

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_borrow` (~224 tokens)

Prepare a loan

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.

Input parameters:

- `asset` (string, required): Token contract address on Base (preferred) or its symbol, e.g. WETH, VIRTUAL, esALB
- `borrower` (string, required): Wallet that will sign; used to skip unneeded approvals and check balances
- `collateral_amount` (string, required): Collateral to offer, in token units, e.g. 0.5. It is a maximum: only what the loan needs is taken
- `loan_amount_usdc` (string): Loan amount before the fee, in USDC. Omit to borrow the most the collateral allows
- `max_shortfall_bps` (integer): Max gap between requested and funded amount in basis points. Omit for the protocol default.
- `term` (required): Loan term: short, medium or long (or 0/1/2). Durations and costs come from get_protocol_info.

### `build_buyback` (~103 tokens)

Prepare a buyback

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.

Input parameters:

- `borrower` (string, required): Borrower wallet that will sign; must be the wallet that opened the loan
- `loan_id` (required): Loan ID
- `payment_usdc` (string): USDC to pay. Omit to pay everything left and get all collateral back

### `build_deposit` (~120 tokens)

Prepare a lending deposit

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.

Input parameters:

- `amount_usdc` (string, required): USDC to deposit, e.g. 500
- `lender` (string, required): Lender wallet that will sign; used to skip unneeded approvals and check balances
- `limits` (array): Per-token lending limits to set in the same transaction. A first deposit needs at least one to be lent

### `build_set_limits` (~70 tokens)

Prepare per-token lending limits

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.

Input parameters:

- `lender` (string, required): Lender wallet that will sign
- `limits` (array, required): Tokens and the max USDC to lend against each

### `build_withdraw` (~115 tokens)

Prepare a withdrawal

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.

Input parameters:

- `amount_usdc` (required): USDC to withdraw, or "max" for everything not in active loans
- `as_musdc` (boolean): Receive mUSDC vault shares instead of USDC, skipping the 0.25% withdrawal fee
- `lender` (string, required): Lender wallet that will sign

### `build_claim_proceeds` (~98 tokens)

Prepare a proceeds claim

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.

Input parameters:

- `loan_ids` (array, required): IDs of loans you funded, from get_lender_position (1 to 50)
- `mode` (string): withdraw sends the USDC to your wallet (default); redeploy puts it back into lending

### `build_claim_collateral` (~63 tokens)

Prepare a collateral claim

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

Input parameters:

- `loan_ids` (array, required): IDs of past-due loans you funded, from get_lender_position (1 to 50)

### `build_set_auto_redeploy` (~53 tokens)

Prepare auto re-lend setting

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

Input parameters:

- `enabled` (boolean, required): true to re-lend repaid principal automatically, false to keep it available to withdraw

### `simulate_transaction` (~119 tokens)

Simulate a transaction

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.

Input parameters:

- `data` (string, required): The step's calldata, as returned by a build_ tool
- `from` (string, required): Wallet that would send the transaction
- `to` (string, required): The step's to address, as returned by a build_ tool
- `value` (string): Native value in wei. Always 0 for Based Loans calls

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/0xvarius-basedloans/mcp#diagnostics

## Score history

- 2026-11-21: 74
- 2026-11-20: 74
- 2026-11-19: 73
- 2026-11-18: 73
- 2026-11-17: 72
- 2026-11-16: 72

## Common questions

### What is the Based Loans MCP server?

Based Loans is an MCP server listed in the public MCP registry as io.github.0xVarius/basedloans. Borrow USDC against Base tokens with no liquidations, or lend USDC. Quotes, risk data, unsigned txs. This page covers its hosted endpoint (https://mcp.based.loans/mcp).

### Is the Based Loans MCP server safe to use?

Based Loans scores 74 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Based Loans MCP server expose?

Based Loans exposes 19 tools: get_protocol_info, list_markets, get_market, get_risk_report, quote_borrow, and 14 more. Their descriptions and schemas cost roughly 1,743 tokens of context every time the server is loaded.

### Does the Based Loans MCP server require authentication?

No. We connected to Based Loans without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Based Loans MCP server still maintained?

Based Loans is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Based Loans MCP server?

VerifyMCP ran 13 checks on Based Loans, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://mcp.based.loans/mcp
- Repository: https://github.com/0xVarius/basedloans-agents
- Website: https://based.loans/
- Changelog RSS feed: https://verifymcp.io/servers/0xvarius-basedloans/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/0xvarius-basedloans/mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/0xvarius-basedloans/mcp.json
- HTML version of this page: https://verifymcp.io/servers/0xvarius-basedloans/mcp
