Protocol

Developers

MCP server

A read-only Model Context Protocol server for Boros. Connect any MCP-compatible agent to query markets, accounts, settlements, and vaults with source-backed facts, units, and freshness.

Endpoint: mcp.borosexplorer.com/mcp
Transport: Streamable HTTP
Auth: Public
Mode: read-only

Connect

Add the server to any MCP-compatible client (Claude Desktop, Cursor, Continue, your own agent runtime). The transport is Streamable HTTP and the endpoint is public — no headers, keys, or handshake.

json·mcp-client-config.json

{
  "mcpServers": {
    "boros-explorer": {
      "url": "https://mcp.borosexplorer.com/mcp"
    }
  }
}

Once connected, the client lists the tools and resources below. Start with lookup_market to resolve a market ID, then call any of the detail tools.

Trading and wallet actions

Boros Explorer's MCP is read-only: market reads, account context, settlement history, vault snapshots, and freshness checks. It can't simulate, sign, or submit anything.

For trading, use Pendle's official Boros MCP, @pendle/boros-mcp. It runs locally and links to your browser wallet, so an agent can place, cancel, and close orders and manage AMM liquidity through your own account.

bash·claude-code

claude mcp add boros -- npx -y @pendle/boros-mcp

toml·~/.codex/config.toml

[mcp_servers.boros]
command = "npx"
args = ["-y", "@pendle/boros-mcp"]

Rule of thumb: boros-explorer for data, boros for execution.

Response envelope

Every tool and resource returns the same JSON envelope. Read data for results and check caveats and freshness before summarizing — they flag unit conventions, explicit raw fields, and stale sources.

json·envelope.json

{
  "asOf": "2026-04-25T12:00:00.000Z",
  "sources": ["gql", "boros_rest"],
  "freshness": { "latestObservedAt": "2026-04-25T11:59:42.000Z", "stale": false },
  "units": { "apr": "decimal", "timestamps": "utc_iso", "size": "mixed_explicit", "raw": "explicit_raw_fields" },
  "caveats": ["Agent-facing APR, YU, fee, and USD fields are already normalized."],
  "data": { /* tool- or resource-specific payload */ }
}

Units

MCP responses are normalized for agents by default. Fields such as rateApr, impliedApr, floatingApr, signedSizeYu, absSizeYu, sizeUsd, and feeUsd are already analysis-ready numbers. Do not divide them by 1e18.

Raw protocol integers are only exposed when the field name says raw, for example signedSizeRawWad, rateRawWad, feeRawWad, or account fields ending in Raw. Those values are returned as strings for debugging and low-level modeling; use the companion normalized field for ordinary summaries. YU/notional fields are not USD unless a field explicitly says Usd.

Tools

Agents call tools by name with bounded inputs. Each returns the envelope above with a tool-shaped data payload.

Tool	Purpose
lookup_market	Find Boros markets by ID, symbol, asset, venue, expiry, or fuzzy text.
get_market_detail	Bounded detail for one numeric Boros market ID.
get_market_parameters	Indexed and Boros OpenAPI protocol parameters for one market.
screen_markets	Bounded candidate set for agent-side market analysis.
compare_markets	Compare a small set of markets using normalized explorer fields.
get_market_trends	Bounded OI and trade-volume trend rows over two equal windows.
get_recent_trades	Recent indexed trades for one market ID.
get_account_positions	Active positions for a wallet root and account ID, with market context.
get_account_market_info	Balance, margin, position, and open-order fields for MarketAcc IDs.
get_protocol_summary	Headline protocol stats over a bounded window with previous-window deltas.
get_protocol_activity	Today/activity packet with headline stats, movers, and notable rows.
get_settlements	Bounded settlement rows with exchange funding and Boros context.
get_vault_snapshots	Snapshot-backed AMM vault TVL, APY, capacity, and utilization.
check_freshness	Source freshness globally or for one market ID.

Resources

Resources are addressable reads. Use them when the agent needs a fixed view rather than a tool call.

URI	Returns
boros://markets	Live and pending markets list.
boros://markets/{marketId}	One market's identity and current state.
boros://markets/{marketId}/parameters	Tick, margin, fee, and cap parameters.
boros://protocol/summary	Headline protocol stats.
boros://protocol/activity	Recent activity packet.
boros://accounts/{root}/positions	Active positions for a wallet root.
boros://settlements/{marketId}	Settlement window data for one market.
boros://vaults	AMM vault snapshots.
boros://strategy-recipes	Static strategy recipes referenced by skills.
boros://freshness	Latest source timestamps and stale flags.

Out of scope

A few things this server intentionally doesn't do:

Tools return facts and rows, not recommendations or rankings.
Calldata generation and transaction signing aren't included.
Simulation previews aren't included; use Pendle's local Boros MCP for execution previews.
Order management and position changes aren't supported — reads only.
Realtime feeds stay on Boros-owned channels; this server returns indexed snapshots.

See the MCP skill examples for worked agent workflows that combine these tools.