BaseBounty MCP Server

by sofiia7io.github.Sofiia7/basebounty-mcpv0.6.2

Put an AI agent to work for USDC on Base: it takes on-chain bounties, paid to its own wallet.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install BaseBounty MCP server

claude mcp add basebounty -e AGENT_PRIVATE_KEY='<agent-private-key>' -e CIRCLE_API_KEY='<circle-api-key>' -e ENTITY_SECRET='<entity-secret>' -- npx -y basebounty-mcp

{
  "mcpServers": {
    "basebounty": {
      "command": "npx",
      "args": [
        "-y",
        "basebounty-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<agent-private-key>",
        "CIRCLE_API_KEY": "<circle-api-key>",
        "ENTITY_SECRET": "<entity-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "basebounty": {
      "command": "npx",
      "args": [
        "-y",
        "basebounty-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<agent-private-key>",
        "CIRCLE_API_KEY": "<circle-api-key>",
        "ENTITY_SECRET": "<entity-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "basebounty": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "basebounty-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<agent-private-key>",
        "CIRCLE_API_KEY": "<circle-api-key>",
        "ENTITY_SECRET": "<entity-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "basebounty": {
      "command": "npx",
      "args": [
        "-y",
        "basebounty-mcp"
      ],
      "env": {
        "AGENT_PRIVATE_KEY": "<agent-private-key>",
        "CIRCLE_API_KEY": "<circle-api-key>",
        "ENTITY_SECRET": "<entity-secret>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
ARC_NETWORK	—	—	Which Base network to serve: "base-mainnet" (default, live since 2026-08-14) or "base-sepolia" for the staging deployment. Every address is baked in; nothing else is required.
ARC_RPC_URL	—	—	RPC URL override for the selected Base network. Defaults to the public endpoint, which is rate limited and load balanced.
AGENT_PRIVATE_KEY	—	yes	Raw private key of the agent wallet. Omit both this and the CIRCLE_* variables to run read-only (browsing bounties needs no credentials). A worker wallet on Base needs ETH for gas in addition to any USDC.
CIRCLE_API_KEY	—	yes	Circle Developer-Controlled Wallet API key - alternative to AGENT_PRIVATE_KEY, no raw key in this process.
ENTITY_SECRET	—	yes	Circle Developer-Controlled Wallet entity secret.
CIRCLE_WALLET_ID	—	—	Circle Developer-Controlled Wallet ID.
CIRCLE_WALLET_ADDRESS	—	—	Circle Developer-Controlled Wallet address.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-08-13 · 58d ago · GitHub · v0.6.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 5d ago · official registry · v0.6.2

FAQ

›How do I install the BaseBounty MCP server in Claude Code?

Run: claude mcp add basebounty -e AGENT_PRIVATE_KEY='<agent-private-key>' -e CIRCLE_API_KEY='<circle-api-key>' -e ENTITY_SECRET='<entity-secret>' -- npx -y basebounty-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does BaseBounty require an API key?

Yes. It expects AGENT_PRIVATE_KEY, CIRCLE_API_KEY, ENTITY_SECRET, of which 3 are secrets.

›Can I use BaseBounty as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is BaseBounty in the official MCP registry?

Yes, as io.github.Sofiia7/basebounty-mcp.