@0xwh1sker/mantle-mcp 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mantle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @0xwh1sker/mantle-mcp
+
+MCP server for AI-driven Mantle L2 development — chain reads, simulation, and unsigned transaction building.
+
+## Install
+
+```bash
+npm install @0xwh1sker/mantle-mcp
+```
+
+## Usage
+
+Run the MCP server over stdio:
+
+```bash
+npx @0xwh1sker/mantle-mcp
+```
+
+Or add to your Claude Desktop / MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "mantle": {
+      "command": "npx",
+      "args": ["@0xwh1sker/mantle-mcp"]
+    }
+  }
+}
+```
+
+## Related packages
+
+- [`@0xwh1sker/mantle-core`](https://www.npmjs.com/package/@0xwh1sker/mantle-core) — shared Mantle L2 business logic
+- [`@0xwh1sker/mantle-cli`](https://www.npmjs.com/package/@0xwh1sker/mantle-cli) — CLI for Mantle chain reads, DeFi queries, and transaction building
+
+## License
+
+MIT

package/SERVER_INSTRUCTIONS.md

@@ -0,0 +1,33 @@
+# mantle-mcp Server Instructions
+
+Mantle L2 tools for AI agents. Read chain state, simulate transactions, and build unsigned payloads.
+
+## Rules
+
+### 1. Never Hold Private Keys
+
+`mantle-mcp` never signs and never broadcasts transactions. All build tools return unsigned payloads only.
+
+### 2. Verify Addresses Through Registry/Token Resolution
+
+Before any transaction-building path, resolve/validate addresses with:
+
+- `mantle_resolveAddress`
+- `mantle_validateAddress`
+- `mantle_resolveToken` (with canonical token-list cross-check)
+
+### 3. Simulate Before Presenting
+
+Always present a fresh simulation result before any signing step.
+
+### 4. Present `human_summary` Before Signing
+
+Every transaction-building tool must return and display `human_summary` prior to user confirmation/signing.
+
+### 5. MNT is the Gas Token
+
+Mantle gas estimates and native balances are denominated in MNT (not ETH).
+
+### 6. Never Fabricate Data
+
+If price/address/simulation data cannot be trusted, return typed errors or explicit null/low-confidence outputs instead of guessed values.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+async function main() {
+    const { runServer } = await import("./server.js");
+    await runServer();
+}
+main().catch((error) => {
+    // stderr logging only, so MCP stdio payload remains clean.
+    console.error("Fatal:", error);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/skills-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check whether the skills submodule checkout is reachable.
+ * Returns true when running inside the monorepo with skills initialized,
+ * false for standalone npm consumers.
+ */
+export declare function isSkillsCheckoutAvailable(baseDir?: string): boolean;
+export declare function readSkillsReference(relativePath: string, baseDir?: string): string;
+//# sourceMappingURL=skills-path.d.ts.map

package/dist/lib/skills-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-path.d.ts","sourceRoot":"","sources":["../../src/lib/skills-path.ts"],"names":[],"mappings":"AAgCA;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,SAAY,GAAG,OAAO,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,SAAY,GAAG,MAAM,CAqBrF"}

package/dist/lib/skills-path.js

@@ -0,0 +1,50 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Resolve the monorepo root where the skills/ submodule lives.
+ * Walk up from this module's compiled location until we find a directory
+ * containing a skills/ folder or .gitmodules, falling back to cwd.
+ */
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function findRepoRoot() {
+    let dir = path.resolve(__dirname);
+    const { root } = path.parse(dir);
+    while (dir !== root) {
+        if (existsSync(path.join(dir, "skills")) || existsSync(path.join(dir, ".gitmodules"))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    // skills/ not found in any ancestor — likely running from an npm install
+    // rather than the monorepo checkout.  Fall back to cwd but warn.
+    console.error("[mantle-mcp] Could not locate the skills/ submodule. " +
+        "If running from the monorepo, run `npm run skills:init`. " +
+        "Falling back to process.cwd().");
+    return process.cwd();
+}
+const REPO_ROOT = findRepoRoot();
+/**
+ * Check whether the skills submodule checkout is reachable.
+ * Returns true when running inside the monorepo with skills initialized,
+ * false for standalone npm consumers.
+ */
+export function isSkillsCheckoutAvailable(baseDir = REPO_ROOT) {
+    return existsSync(path.resolve(baseDir, "skills"));
+}
+export function readSkillsReference(relativePath, baseDir = REPO_ROOT) {
+    const absolutePath = path.resolve(baseDir, relativePath);
+    if (existsSync(absolutePath)) {
+        return readFileSync(absolutePath, "utf8");
+    }
+    const skillsRoot = path.resolve(baseDir, "skills");
+    const nestedSkillsPath = path.resolve(baseDir, "skills", relativePath);
+    if (existsSync(nestedSkillsPath)) {
+        return readFileSync(nestedSkillsPath, "utf8");
+    }
+    if (!existsSync(skillsRoot)) {
+        throw new Error(`Missing skills checkout at ${skillsRoot}. Run \`npm run skills:init\` to initialize the mantle-skills submodule.`);
+    }
+    throw new Error(`Missing skills reference file: ${relativePath}`);
+}
+//# sourceMappingURL=skills-path.js.map

package/dist/lib/skills-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-path.js","sourceRoot":"","sources":["../../src/lib/skills-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,SAAS,YAAY;IACnB,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC;QACpB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,yEAAyE;IACzE,iEAAiE;IACjE,OAAO,CAAC,KAAK,CACX,uDAAuD;QACvD,2DAA2D;QAC3D,gCAAgC,CACjC,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAO,GAAG,SAAS;IAC3D,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB,EAAE,OAAO,GAAG,SAAS;IAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEvE,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,UAAU,0EAA0E,CACnH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,20 @@
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+}
+export declare const prompts: PromptDefinition[];
+export declare function getPromptMessages(name: string): PromptMessage[] | null;
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,eAAO,MAAM,OAAO,EAAE,gBAAgB,EAoBrC,CAAC;AASF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI,CAiHtE"}

package/dist/prompts.js

@@ -0,0 +1,133 @@
+export const prompts = [
+    {
+        name: "mantle_portfolioAudit",
+        description: "Guide through a complete Mantle wallet audit: balances, allowances, and risk exposure.",
+        arguments: [
+            { name: "wallet_address", description: "Wallet address to audit.", required: true },
+            { name: "network", description: "mainnet or sepolia (default mainnet).", required: false },
+            { name: "scope", description: "full, balances_only, or allowances_only.", required: false }
+        ]
+    },
+    {
+        name: "mantle_mantleBasics",
+        description: "Mantle network fundamentals for agents new to the ecosystem. Covers chain architecture, key tokens, and protocol landscape.",
+        arguments: []
+    },
+    {
+        name: "mantle_gasConfiguration",
+        description: "CRITICAL: MNT gas token guidance, fee estimation, and RPC configuration for Mantle.",
+        arguments: []
+    }
+];
+function prompt(user, assistant) {
+    return [
+        { role: "user", content: { type: "text", text: user } },
+        { role: "assistant", content: { type: "text", text: assistant } }
+    ];
+}
+export function getPromptMessages(name) {
+    switch (name) {
+        case "mantle_portfolioAudit":
+            return prompt("How do I audit a wallet's portfolio on Mantle?", `# Mantle Portfolio Audit Workflow
+
+## Step 1: Confirm Network
+Call mantle_getChainInfo and mantle_getChainStatus first so chain id, RPC health, and gas context are explicit.
+
+## Step 2: Read Native Balance
+Use mantle_getBalance({ address: "<wallet>", network: "mainnet" })
+
+## Step 3: Read ERC-20 Balances
+Use mantle_getTokenBalances with curated symbols from mantle://registry/tokens.
+
+## Step 4: Read Allowance Exposure
+Use mantle_getAllowances({ owner: "<wallet>", pairs: [...] }) against known routers/spenders from mantle://registry/protocols.
+
+## Step 5: Price and Valuation
+Call mantle_getTokenPrices for each held token. Never fabricate missing prices.
+
+## Step 6: Risk Classification
+| Risk Level | Condition |
+|------------|-----------|
+| low | No unlimited allowances + diversified holdings |
+| medium | One or more high notional allowances |
+| high | Unlimited approval to core spenders or concentrated volatile holdings |
+
+## Step 7: Final Report
+Output: native balance, token balances, allowances, USD valuation totals, and explicit data gaps.
+
+## Common Mistakes
+| Mistake | Fix |
+|---------|-----|
+| Ignoring allowances | Always include token+spender allowance matrix |
+| Fabricating USD values | Keep value null when price missing |
+| Mixing networks | Normalize to mainnet/sepolia before tool calls |
+`);
+        case "mantle_mantleBasics":
+            return prompt("What is Mantle and how does it work?", `# Mantle Network Fundamentals
+
+## Architecture
+Mantle is an Ethereum L2 built with OP Stack and data availability optimizations.
+
+## Key Facts
+| Property | Value |
+|----------|-------|
+| Chain ID | 5000 (mainnet), 5003 (sepolia) |
+| Gas Token | MNT |
+| Block Time | ~2 seconds |
+| Finality | L1 confirmation dependent |
+
+## Core Tokens
+| Token | Address (mainnet) |
+|-------|-------------------|
+| WMNT | 0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8 |
+| USDC | 0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9 |
+| USDT | 0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE |
+
+## DeFi Landscape
+| Protocol | Category | Status |
+|----------|----------|--------|
+| Agni | DEX | enabled |
+| Merchant Moe | DEX | enabled |
+| Aave v3 | lending | enabled |
+| Ondo | RWA | planned post-v1 |
+
+## Getting Started
+1. mantle_getChainInfo({ network: "mainnet" })
+2. mantle_getChainStatus({ network: "mainnet" })
+3. Read mantle://registry/tokens and mantle://registry/protocols
+`);
+        case "mantle_gasConfiguration":
+            return prompt("How does gas work on Mantle?", `# Mantle Gas Configuration
+
+## CRITICAL: Gas Token is MNT, Not ETH
+All gas estimates and native balances are denominated in MNT.
+
+## Gas Costs (Very Cheap)
+| Operation | Typical Gas | Approx MNT Cost |
+|-----------|-------------|------------------|
+| MNT transfer | 21,000 | ~0.0002 |
+| ERC-20 transfer | 65,000 | ~0.0006 |
+| DEX swap | 180,000 | ~0.0016 |
+| Contract deployment | 1M-3M | ~0.01-0.03 |
+
+## Checking Live Gas
+Use mantle_getChainStatus({ network: "mainnet" }) and report gas_price_gwei + block_number.
+
+## RPC Endpoints
+| Network | URL |
+|---------|-----|
+| Mainnet | https://rpc.mantle.xyz |
+| Sepolia | https://rpc.sepolia.mantle.xyz |
+
+## Common Mistakes
+| Mistake | Fix |
+|---------|-----|
+| Assuming ETH is gas token | Use MNT for all fee math |
+| Reusing Ethereum gas assumptions | Recalculate on Mantle chain status |
+| Ignoring RPC fallback | Configure dedicated RPC + fallback endpoint |
+`);
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,wFAAwF;QACrG,SAAS,EAAE;YACT,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE;YACnF,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC1F,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,0CAA0C,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC5F;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,6HAA6H;QAC1I,SAAS,EAAE,EAAE;KACd;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,qFAAqF;QAClG,SAAS,EAAE,EAAE;KACd;CACF,CAAC;AAEF,SAAS,MAAM,CAAC,IAAY,EAAE,SAAiB;IAC7C,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACvD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,uBAAuB;YAC1B,OAAO,MAAM,CACX,gDAAgD,EAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCP,CACM,CAAC;QACJ,KAAK,qBAAqB;YACxB,OAAO,MAAM,CACX,sCAAsC,EACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCP,CACM,CAAC;QACJ,KAAK,yBAAyB;YAC5B,OAAO,MAAM,CACX,8BAA8B,EAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BP,CACM,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,8 @@
+import type { Resource } from "@0xwh1sker/mantle-core/types.js";
+export declare function listResources(): Resource[];
+export declare function readResource(uri: string): {
+    content: string;
+    mimeType: string;
+} | null;
+export declare function prefetchResources(): Promise<void>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAwDhE,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgFtF;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD"}

package/dist/resources.js

@@ -0,0 +1,138 @@
+import { CHAIN_CONFIGS } from "@0xwh1sker/mantle-core/config/chains.js";
+import { getRegistryData } from "@0xwh1sker/mantle-core/lib/registry.js";
+import { readSkillsReference } from "./lib/skills-path.js";
+import { MANTLE_TOKENS } from "@0xwh1sker/mantle-core/config/tokens.js";
+import { MANTLE_PROTOCOLS } from "@0xwh1sker/mantle-core/config/protocols.js";
+import { capabilityCatalog } from "@0xwh1sker/mantle-core/capability-catalog.js";
+const RESOURCES = [
+    {
+        uri: "mantle://chain/mainnet",
+        name: "Mantle Mainnet Configuration",
+        description: "Static chain configuration for Mantle mainnet.",
+        mimeType: "application/json"
+    },
+    {
+        uri: "mantle://chain/sepolia",
+        name: "Mantle Sepolia Testnet Configuration",
+        description: "Static chain configuration for Mantle Sepolia.",
+        mimeType: "application/json"
+    },
+    {
+        uri: "mantle://registry/contracts",
+        name: "Mantle Verified Contract Registry",
+        description: "Curated contract registry for address resolution workflows.",
+        mimeType: "application/json"
+    },
+    {
+        uri: "mantle://registry/tokens",
+        name: "Mantle Token Registry",
+        description: "Embedded quick-reference token list for Mantle networks.",
+        mimeType: "application/json"
+    },
+    {
+        uri: "mantle://registry/protocols",
+        name: "Mantle DeFi Protocol Registry",
+        description: "Protocol metadata for enabled and planned Mantle integrations.",
+        mimeType: "application/json"
+    },
+    {
+        uri: "mantle://docs/network-basics",
+        name: "Mantle Network Basics",
+        description: "Network fundamentals from mantle-network-primer references.",
+        mimeType: "text/markdown"
+    },
+    {
+        uri: "mantle://docs/risk-checklist",
+        name: "Transaction Risk Checklist",
+        description: "Pre-execution risk checklist from mantle-risk-evaluator references.",
+        mimeType: "text/markdown"
+    },
+    {
+        uri: "mantle://registry/capabilities",
+        name: "Mantle Tool Capability Catalog",
+        description: "Structured catalog of all MCP tools with semantic classification (query/analyze/execute), " +
+            "read/write nature, wallet requirements, and usage examples. " +
+            "Use this to quickly find the right tool for a task.",
+        mimeType: "application/json"
+    }
+];
+export function listResources() {
+    return RESOURCES;
+}
+export function readResource(uri) {
+    if (uri === "mantle://chain/mainnet") {
+        return {
+            content: JSON.stringify(CHAIN_CONFIGS.mainnet, null, 2),
+            mimeType: "application/json"
+        };
+    }
+    if (uri === "mantle://chain/sepolia") {
+        return {
+            content: JSON.stringify(CHAIN_CONFIGS.sepolia, null, 2),
+            mimeType: "application/json"
+        };
+    }
+    if (uri === "mantle://registry/contracts") {
+        return {
+            content: JSON.stringify(getRegistryData(), null, 2),
+            mimeType: "application/json"
+        };
+    }
+    if (uri === "mantle://registry/tokens") {
+        return {
+            content: JSON.stringify(MANTLE_TOKENS, null, 2),
+            mimeType: "application/json"
+        };
+    }
+    if (uri === "mantle://registry/protocols") {
+        return {
+            content: JSON.stringify(MANTLE_PROTOCOLS, null, 2),
+            mimeType: "application/json"
+        };
+    }
+    if (uri === "mantle://docs/network-basics") {
+        try {
+            return {
+                content: readSkillsReference("skills/mantle-network-primer/references/mantle-network-basics.md"),
+                mimeType: "text/markdown"
+            };
+        }
+        catch {
+            return {
+                content: "<!-- mantle-mcp: skills submodule not available -->\n" +
+                    "# Mantle Network Basics\n\n" +
+                    "This resource requires the `skills/` submodule which is not available in a standalone npm install.\n" +
+                    "If you are running from the monorepo, run `npm run skills:init` to initialize it.\n",
+                mimeType: "text/markdown"
+            };
+        }
+    }
+    if (uri === "mantle://docs/risk-checklist") {
+        try {
+            return {
+                content: readSkillsReference("skills/mantle-risk-evaluator/references/risk-checklist.md"),
+                mimeType: "text/markdown"
+            };
+        }
+        catch {
+            return {
+                content: "<!-- mantle-mcp: skills submodule not available -->\n" +
+                    "# Transaction Risk Checklist\n\n" +
+                    "This resource requires the `skills/` submodule which is not available in a standalone npm install.\n" +
+                    "If you are running from the monorepo, run `npm run skills:init` to initialize it.\n",
+                mimeType: "text/markdown"
+            };
+        }
+    }
+    if (uri === "mantle://registry/capabilities") {
+        return {
+            content: JSON.stringify(capabilityCatalog(), null, 2),
+            mimeType: "application/json"
+        };
+    }
+    return null;
+}
+export async function prefetchResources() {
+    return Promise.resolve();
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(): Server;
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAmBnE,wBAAgB,YAAY,IAAI,MAAM,CA0FrC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB/C"}

package/dist/server.js

@@ -0,0 +1,102 @@
+import { readFileSync } from "node:fs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { MantleMcpError, toErrorPayload } from "@0xwh1sker/mantle-core/errors.js";
+import { getPromptMessages, prompts } from "./prompts.js";
+import { listResources, prefetchResources, readResource } from "./resources.js";
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+export function createServer() {
+    const server = new Server({ name: "mantle-mcp", version: pkg.version }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+        }
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: Object.values(allTools).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        }))
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        const tool = allTools[name];
+        if (!tool) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: true,
+                            code: "UNKNOWN_TOOL",
+                            message: `Unknown tool: ${name}`,
+                            suggestion: "Call ListTools first to discover available tool names.",
+                            details: null
+                        })
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const result = await tool.handler(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(toErrorPayload(error)) }],
+                isError: true
+            };
+        }
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listResources()
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        const resource = readResource(uri);
+        if (!resource) {
+            return {
+                contents: [{ uri, mimeType: "text/plain", text: `Resource not found: ${uri}` }]
+            };
+        }
+        return {
+            contents: [{ uri, mimeType: resource.mimeType, text: resource.content }]
+        };
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: prompts
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const messages = getPromptMessages(request.params.name);
+        if (!messages) {
+            throw new MantleMcpError("PROMPT_NOT_FOUND", `Prompt not found: ${request.params.name}`, "Call ListPrompts to discover available prompt names.", { name: request.params.name });
+        }
+        return { messages };
+    });
+    return server;
+}
+export async function runServer() {
+    const transportMode = process.env.MANTLE_MCP_TRANSPORT ?? "stdio";
+    if (transportMode !== "stdio") {
+        throw new Error("Only stdio transport is currently supported. Set MANTLE_MCP_TRANSPORT=stdio.");
+    }
+    const server = createServer();
+    await prefetchResources();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const shutdown = async () => {
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@0xwh1sker/mantle-mcp",
+  "version": "0.1.3",
+  "license": "MIT",
+  "description": "MCP server for AI-driven Mantle L2 development — chain reads, simulation, and unsigned transaction building",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "bin": {
+    "mantle-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "SERVER_INSTRUCTIONS.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "mcp": {
+    "serverUseInstructions": "Mantle L2 chain tools. Gas token is MNT, not ETH. CRITICAL RULES: (1) NEVER hold or request private keys - all transaction tools return unsigned payloads only. (2) ALWAYS call mantle_resolveAddress or mantle_resolveToken to verify addresses before using them in transaction-building tools; for token symbols, mantle_resolveToken must double-check against https://token-list.mantle.xyz. (3) ALWAYS ensure a fresh simulation result before presenting a transaction for signing (for mantle_build*Tx, use the returned simulation field; use mantle_simulateTx for custom calldata or re-simulation). (4) ALWAYS present the human_summary field to the user and obtain explicit confirmation before any signing step. (5) Gas estimates and native balances are in MNT. (6) When an address cannot be resolved through the registry, STOP and ask the user rather than proceeding with an unverified address."
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@0xwh1sker/mantle-core": "0.1.3",
+    "@modelcontextprotocol/sdk": "~1.27.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}