@zeromodern/mcp-server-0mod

npm TypeScript License: MIT

Model Context Protocol (MCP) server wrapping the 0mod API Gateway edge tools for any AI agent. HTTP 402 micropayments on Base EVM are handled automatically.

Wallet & Network Prerequisites

0mod gateway utilities use x402 HTTP 402 micropayments on Base EVM:

Network: Base Mainnet (eip155:8453)
Asset: USDC on Base
Environment Variable: PAYER_PRIVATE_KEY=0x... (or EVM_PRIVATE_KEY / X402_PRIVATE_KEY)

When PAYER_PRIVATE_KEY is present in the environment, tool calls transparently sign payment authorizations and execute with zero manual intervention.

Requirements

Node.js >= 18
npm >= 9

Install

npm install @zeromodern/mcp-server-0mod

Setup & Configuration

Claude Desktop (`claude_desktop_config.json`)

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "0mod": {
      "command": "npx",
      "args": ["-y", "@zeromodern/mcp-server-0mod"],
      "env": {
        "PAYER_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

OpenCode / Cursor / CLI

Run directly via npx:

PAYER_PRIVATE_KEY=0x_your_private_key_here npx -y @zeromodern/mcp-server-0mod

Available Tools

💡 Pricing: For live per-call pricing and endpoint status across all tools, visit api.0mod.com or fetch https://api.0mod.com/api/v1/discovery.

Tool Name	Description	Input Schema Example
`stealth_dom`	Headless web page fetch from Cloudflare edge	`{ "url": "https://example.com" }`
`airgap_scrub`	Redact SSN, phone, email, ZIP via Workers AI	`{ "text": "Call me at 555-0199" }`
`rag_shrink`	Strip HTML boilerplate to clean Markdown for RAG	`{ "html": "<html>...</html>" }`
`code_denoise`	Remove comments, docstrings, sourcemaps from code	`{ "code": "const x = 1;" }`
`domain_check`	Query RDAP registry for domain availability	`{ "domain": "example.com" }`
`dex_price_summary`	Real-time DEX token price, volume, liquidity	`{ "query": "USDC" }`
`x_sentiment`	Social & market sentiment scoring	`{ "topic": "crypto market" }`
`image_ocr_shrink`	Vision OCR text and table extraction	`{ "imageUrl": "https://..." }`
`embed_text`	768-dim text embedding generation	`{ "text": "sample text" }`
`embed_multilingual`	1024-dim multilingual text embedding generation	`{ "text": "sample text" }`
`summarize_text`	Executive TL;DR document summarization	`{ "text": "long text string" }`

Ecosystem Packages

🤖 MCP Server (Any AI Agent): @zeromodern/mcp-server-0mod
🟣 ElizaOS Plugin: @zeromodern/eliza-plugin-0mod
🔵 Coinbase AgentKit Provider: @zeromodern/agentkit-provider-0mod
⚡️ Live Gateway Service: api.0mod.com

Smithery

This server is registered on Smithery for one-click deployment.

Troubleshooting

Server not connecting: Verify your MCP client supports stdio transport. Check that PAYER_PRIVATE_KEY is passed in the env block.
Authentication / Payment errors: Ensure PAYER_PRIVATE_KEY is set with a valid Base EVM private key holding a USDC balance for x402 micropayments.
Timeout errors: Micropayment verification on Base adds network latency. Increase your MCP client's request timeout if needed.

License

MIT