Skip to content

x402 Ecosystem Integration Guides

This directory contains integration guides for connecting x402 payments to various repositories in the nirholas ecosystem.

📚 Guides

MCP Registry Servers

Guide Registry ID Description
abi-to-mcp io.github.nirholas/abi-to-mcp Premium ABI conversions, complex contracts
crypto-market-data io.github.nirholas/crypto-market-data Pay-per-query premium data tiers
crypto-tools-registry io.github.nirholas/crypto-tools-registry Featured listings, marketplace sync
defi-agents io.github.nirholas/defi-agents Payment-capable agent definitions
ethereum-wallet-mcp io.github.nirholas/ethereum-wallet-mcp Vanity addresses, bulk generation
extract-llms-docs io.github.nirholas/extract-llms-docs Bulk extraction, recurring updates
free-crypto-news io.github.nirholas/free-crypto-news Premium news tier with paywall
github-to-mcp io.github.nirholas/github-to-mcp Premium conversions, private repos
keystore-mcp-server io.github.nirholas/keystore-mcp-server HSM integration, audit logging
mcp-notify io.github.nirholas/mcp-notify Premium alerts, webhooks
repo-intel io.github.nirholas/repo-intel Security audits, continuous monitoring
signing-mcp-server io.github.nirholas/signing-mcp-server Per-signature fees, batch signing
solidity-compiler io.github.nirholas/solidity-compiler Optimization, security scans
sperax-crypto-mcp io.github.nirholas/sperax-crypto-mcp ⭐ Native USDs yield integration
tool-discovery-mcp io.github.nirholas/tool-discovery-mcp AI recommendations, batch discovery
transaction-mcp-server io.github.nirholas/transaction-mcp-server Batch txs, Flashbots, gas optimization
validation-mcp-server io.github.nirholas/validation-mcp-server Bulk validation, ENS resolution

Other Ecosystem Repos

Guide Repository Description
AI-Agents-Library nirholas/AI-Agents-Library Payment-capable agent templates
plugin.delivery nirholas/plugin.delivery x402 pricing for plugin marketplace
lyra-registry nirholas/lyra-registry Tool pricing with registry

🎯 Integration Priority

  1. Tier 1: Core Infrastructure (Week 1)
  2. universal-crypto-mcp ✅ (this repo)
  3. x402-stablecoin (already built)

  4. x402-ecosystem package ✅

  5. Tier 2: Agent Layer (Week 2)

  6. defi-agents

  7. AI-Agents-Library

  8. Tier 3: Distribution (Week 3)

  9. plugin.delivery

  10. lyra-registry

  11. Tier 4: Content Monetization (Week 4)

  12. free-crypto-news
  13. Other content APIs

🔧 Common Integration Pattern

All integrations follow a similar pattern:

import { PayableAgent, registerX402Ecosystem } from "@nirholas/x402-ecosystem";

// 1. Create or extend with payment capabilities
const agent = new PayableAgent({
  privateKey: process.env.X402_PRIVATE_KEY,
  maxDailySpend: "10.00",
});

// 2. Register x402 tools with your MCP server
registerX402Ecosystem(server, {
  enableMarketplace: true,
  enableYield: true,
});

// 3. Use payment methods in your existing code
const result = await agent.payForService(endpoint);

📦 Required Dependencies

npm install @nirholas/x402-ecosystem @nirholas/universal-crypto-mcp