MCP
mantle-mcp
When to use
What it does
MCP server for AI-driven Mantle L2 development - chain reads, simulation, and unsigned transaction building
by mantle-xyzยทv0.1.0
Install
git clone https://github.com/mantle-xyz/mantle-agent-scaffoldmantle-agent-scaffold packages three things together for external Mantle integrations: a pinned skills/ checkout, the Mantle MCP server, and a local CLI built on the same read-oriented capabilities.
Use the root README as a fast map of the repository. Use the docs site for deeper architecture and workflow detail.
npm install
npm run skills:init
npm run build
MANTLE_MCP_TRANSPORT=stdio npm start
This installs dependencies, initializes the pinned skills checkout, builds both entry points, and starts the MCP server from dist/index.js.
The local skills/ checkout is pinned to the external mantle-xyz/mantle-skills repository.
After cloning:
npm run skills:init
When you intentionally want to refresh the pinned checkout:
npm run skills:sync
Project skill definitions live under skills/skills/<skill-name>/SKILL.md.
Minimal usage pattern for external agents:
skills/skills/<skill-name>/SKILL.md.More detail: Skills and MCP Usage
The MCP server is the primary integration surface for hosted assistants, IDE agents, and custom orchestrators. It exposes Mantle chain, registry, account, token, DeFi-read, indexer, and diagnostics capabilities over stdio.
For most clients, the reliable execution sequence is:
listTools, listResources, and listPrompts.readResource or getPrompt.Implementation overview: src/README.md
Minimal MCP client config:
{
"mcpServers": {
"mantle": {
"type": "stdio",
"command": "node",
"args": ["dist/index.js"],
"env": {
"MANTLE_MCP_TRANSPORT": "stdio",
"MANTLE_RPC_URL": "https://rpc.mantle.xyz",
"MANTLE_SEPOLIA_RPC_URL": "https://rpc.sepolia.mantle.xyz"
}
}
}
}
More detail: External Agent Integration
mantle-cli is a local command-line wrapper around the same Mantle read capabilities. It is useful for quick manual inspection, shell workflows, and validating tool behavior without wiring up an MCP client.
Examples:
node dist/cli/index.js chain info
node dist/cli/index.js registry resolve USDC --json
node dist/cli/index.js token prices --tokens USDC,WETH --json
Usage overview: cli/README.md
npm run typecheck
npm test
npm run docs:build
Documentation site: mantle-xyz.github.io/mantle-agent-scaffold
src/ layout and capability summaryIf you are maintaining the docs site itself, the source lives in docs/.