Skip to content
MCP server

Genesis Agent MCP

Pay-per-call x402 MCP tools on Base USDC: Release Guardian + Workflow Runner.

Runs locally
Install
Pricing
Open source
Runs
Locally
Version
1.0.0
Listing updated
2 months ago

About Genesis Agent MCP

Genesis Agent MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add genesis-agent-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- npx -y https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "genesis-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "genesis-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "genesis-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "genesis-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "genesis-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • X402_PRIVATE_KEYBuyer x402 EIP-3009 signing key funded with USDC on Base. Never commit it.Required
  • GENESIS_MAX_SPEND_USDPer-call spending ceiling in USDC (default 0.02).
  • GENESIS_SESSION_BUDGET_USDSession spending budget in USDC (default 1.00).

Pricing

Open source

Genesis Agent MCP FAQ

Is Genesis Agent MCP free?

Yes. Genesis Agent MCP is open source, so you can use and self-host it for free.

How do I add Genesis Agent MCP to Claude Code?

Run this command in your terminal: claude mcp add genesis-agent-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- npx -y https://github.com/genesiscode2026/genesis-agent-tools/releases/download/v1.0.0/genesis-agent-mcp-v1.0.0.mcpb

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers