Skip to main content

Documentation Index

Fetch the complete documentation index at: https://base-a060aa97-youssef-update-agents.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Morpho is a lending protocol on Base. The Morpho MCP server gives your assistant tools to query vaults, check markets, and prepare lending operations — which are then signed and sent through Base MCP.

Demo

How it works

Morpho handles the protocol layer. Your Base Account handles signing.
Morpho’s prepare_* tools simulate the transaction before returning. Review the simulation output before approving — it shows expected state changes, health factors, and any warnings.

Install

Add both MCPs to your assistant:
claude_desktop_config.json
{
  "mcpServers": {
    "base-account": {
      "url": "https://mcp.base.org"
    },
    "morpho": {
      "url": "https://mcp.morpho.org/"
    }
  }
}

Morpho tools

17 tools across read, write (prepare), and simulate.

Read

ToolWhat it does
morpho_health_checkCheck server connectivity
morpho_get_supported_chainsList supported chains
morpho_query_vaultsList vaults with filtering and sorting
morpho_get_vaultDetails for a specific vault
morpho_query_marketsList markets with filtering
morpho_get_marketDetails for a specific market
morpho_get_positionsAll positions for an address (vaults + markets)
morpho_get_token_balanceToken balance and approval state

Prepare (write via send_calls)

These tools return unsigned call data. Pass the result to Base MCP’s send_calls to execute.
ToolWhat it does
morpho_prepare_depositPrepare vault deposit with token approvals
morpho_prepare_withdrawPrepare vault withdrawal (supports max)
morpho_prepare_supplyPrepare market supply with approvals
morpho_prepare_borrowPrepare market borrow with health check
morpho_prepare_repayPrepare market repay (supports max)
morpho_prepare_supply_collateralSupply collateral to a market
morpho_prepare_withdraw_collateralWithdraw collateral with health check

Simulate

ToolWhat it does
morpho_simulate_transactionsSimulate transactions with post-state analysis

Example prompts

Deposit into a vault:
Find the best USDC vault on Base by APY and deposit 100 USDC
Check positions:
Show all my Morpho positions on Base
Borrow against collateral:
Supply 1 ETH as collateral on Morpho and borrow 2000 USDC
Check health:
What's my Morpho borrow health factor?
Withdraw:
Withdraw all my USDC from Morpho vaults

Orchestration pattern

Every Morpho write operation follows the same pattern:
1

Query (optional)

Use a read tool to find the right vault or market: morpho_query_vaults, morpho_get_market, etc.
2

Prepare

Call a prepare_* tool. Morpho simulates the operation and returns { calls, chainId }.
3

Execute via Base Account

Pass calls and chainId to Base MCP’s send_calls. You’ll get an approvalUrl.
4

Approve and confirm

Open the approvalUrl, approve the transaction, then your assistant polls get_request_status.

Execute contract calls

Full guide to send_calls and batching protocol interactions.

Morpho docs

Full Morpho MCP documentation and prompt library.