Mantle Yield MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mantle Yield MCP show me the Mantle yield dashboard summary"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Mantle Yield MCP
Universal MCP server for Mantle yield data, backed by the Mantle Yield API at https://mantle-yield.asterworks.cc.
It is designed to work with any MCP client that can launch a local process over stdio, including terminal agents and editor-based MCP hosts.
What it provides
mantle_get_health— backend health statusmantle_get_summary— dashboard summarymantle_list_opportunities— list opportunities with filters, sorting, and paginationmantle_get_opportunity— full details for a single opportunitymantle_get_opportunity_chart— APY / TVL chart data for one opportunitymantle_compare_opportunities— side-by-side comparison for 2–3 opportunitiesmantle_refresh_data— trigger backend refresh
Related MCP server: MCP COO DeFi
Requirements
Node.js
>= 22npm
Install
git clone https://github.com/Urazanev/mantle-yield-mcp.git
cd mantle-yield-mcp
npm install
npm run buildNo .env file is required for the default setup.
Run locally
npm startIf the process stays open, the server is waiting for an MCP client on stdin / stdout.
Universal MCP setup
Most MCP clients ultimately need the same runtime information:
executable command
absolute path to the built server entrypoint
optional environment variables
Use this runtime shape in your MCP client configuration, adapting only the outer JSON structure to your client:
{
"name": "mantle-yield",
"type": "stdio",
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/mantle-yield-mcp/dist/index.js"
]
}Replace /ABSOLUTE/PATH/TO/mantle-yield-mcp/dist/index.js with the real absolute path on your machine.
Integration notes
Use an absolute path to
dist/index.js.Prefer launching
nodedirectly.Do not use
npm start,npx, or other wrappers as the MCP command, because wrapper output can break the MCP handshake.The server supports both common local stdio framing styles used by MCP hosts:
Content-Lengthframed JSON-RPCnewline-delimited JSON-RPC
Environment variables
All environment variables are optional.
Variable | Default | Description |
|
| Override backend API base URL |
| unset | Optional bearer token |
|
| HTTP timeout in milliseconds |
Development
npm run devor
npm run dev:tsxTroubleshooting
Rebuild after code changes:
npm run buildIf a client hangs on
initialize, verify it launchesnode /absolute/path/to/dist/index.jsdirectly
Notes
Uses only the Mantle Yield backend API as its data source
Does not call DefiLlama directly
Does not parse HTML or read local snapshot files
Does not execute on-chain transactions
Available Tools
7 toolsmantle_compare_opportunitiesA
Compare 2 or 3 yield opportunities side by side. Fetches each opportunity via GET /api/opportunities/:id and returns a unified comparison structure.
Inputs: ids (required).
mantle_get_healthA
Get the technical health status of the Mantle Yield backend service. Calls GET /api/health. Returns status, lastSync, sourcesRefreshed, failedSources. Note: some fields described in the spec (syncedAt, nextRefresh, source, itemCount, fileExists, snapshotPath) are not yet present in the backend response.
Inputs: no named parameters.
mantle_get_opportunityA
Get full details for a single yield opportunity by its ID. Calls GET /api/opportunities/:id.
Inputs: id (required).
mantle_get_opportunity_chartA
Get historical chart data (APY / TVL over time) for a yield opportunity. Calls GET /api/opportunities/:id/chart. NOTE: This backend endpoint is not yet implemented and will return a backend_gap status.
Inputs: id (required).
mantle_get_summaryA
Get the Mantle Yield dashboard summary. Calls GET /api/summary. Returns opportunitiesTracked, protocols, assetsIndexed, lastSync, status.
Inputs: no named parameters.
mantle_list_opportunitiesA
List yield opportunities from the Mantle Yield backend. Calls GET /api/opportunities. Supports filtering, sorting and pagination.
Inputs: page, sort, asset, limit, +4 more.
mantle_refresh_dataA
Trigger a manual data refresh on the backend. Calls POST /api/refresh. NOTE: This backend endpoint is not yet implemented and will return a backend_gap status.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool serves a clearly distinct purpose: health checks, dashboard summary, individual opportunity details, historical charts, listing with filters, comparison, and manual refresh. There is no overlap or ambiguity between tool boundaries.
All tool names follow the same 'mantle_verb_noun' pattern with snake_case throughout. The consistent use of get/list/compare/refresh clearly communicates the action and object for each tool.
With 7 tools, the server is well-scoped for a yield data platform. Each tool covers a distinct aspect of the domain without redundancy or bloat, fitting the ideal 3-15 tool range.
The tool set covers the full read-only lifecycle of yield opportunities: listing, retrieving details, historical charts, comparison, and summary/health status. The included refresh action adds operational coverage, leaving no obvious gaps for the stated purpose.
Related MCP Connectors
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that retrieves statistics from top protocols in the Mantle Network to help users make more informed investment decisions.ISC
- FlicenseNot gradedqualityDmaintenanceAutonomous MCP server for DeFi yield optimization, enabling yield opportunity discovery, treasury snapshots, market signals, and portfolio rebalancing.-
- AlicenseAqualityDmaintenanceMCP server for Hyperliquid that provides read-only on-chain wallet analytics. Enables natural-language queries about positions, fills, funding, and realized PnL for any public address.822 npmMIT
- AlicenseCqualityDmaintenanceMCP server providing tools to search, get, and aggregate Merkl opportunities. Enables querying campaign data, APRs, TVL, and more through natural language.13129 npmMIT