Local stdio MCP server that pays Augur over x402 and exposes the Augur Base contract risk API as MCP tools.

Use this package when you want Augur inside Claude Desktop or another MCP client. Wallet signing stays on your machine while Augur stays a paid HTTP API at https://augurrisk.com.

• local stdio MCP server
• x402 payment stays client-side
• no API key or signup for Augur itself
• two tools out of the box: analyze_base_contract_risk and describe_augur_service

Package name:

augurrisk-mcp

Fastest install path:

npx -y augurrisk-mcp

cd examples/javascript/augur-mcp
npm install
cp .env.example .env

Env:

• CLIENT_PRIVATE_KEY: required only for paid analyze_base_contract_risk calls
• AUGUR_URL: defaults to https://augurrisk.com
• AUGUR_ADDRESS: defaults to 0x4200000000000000000000000000000000000006

npm start

The server communicates over stdio, which is the expected transport for local MCP clients such as Claude Desktop and Codex-compatible clients.

Verify the server starts and the MCP tool list is reachable:

npm run smoke

This startup check does not require CLIENT_PRIVATE_KEY.

Verify one real paid MCP tool call end-to-end:

npm run smoke -- --paid

This paid path does require CLIENT_PRIVATE_KEY.

Preview the publish payload:

npm run pack:preview

Inputs:

• address: Base mainnet contract address

Behavior:

• calls Augur's paid /analyze endpoint
• handles the x402 payment handshake locally with your wallet
• returns both text output and structured JSON content

Returns the configured Augur base URL, default example address, and payment path details without exposing the local payer wallet address.

{
  "mcpServers": {
    "augur": {
      "command": "npm",
      "args": ["start", "--prefix", "/absolute/path/to/risk-api/examples/javascript/augur-mcp"],
      "env": {
        "CLIENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "AUGUR_URL": "https://augurrisk.com"
      }
    }
  }
}

{
  "mcpServers": {
    "augur": {
      "command": "npx",
      "args": ["-y", "augurrisk-mcp"],
      "env": {
        "CLIENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "AUGUR_URL": "https://augurrisk.com"
      }
    }
  }
}

If you prefer not to place the private key directly in the Claude config, start the server from a shell where CLIENT_PRIVATE_KEY is already set.

On Windows, Claude Desktop config typically lives at:

%APPDATA%\Claude\claude_desktop_config.json

Example Windows entry for this repo:

{
  "mcpServers": {
    "augur": {
      "command": "npm",
      "args": [
        "start",
        "--prefix",
        "C:\\Users\\justi\\dev\\risk-api\\examples\\javascript\\augur-mcp"
      ],
      "env": {
        "CLIENT_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "AUGUR_URL": "https://augurrisk.com",
        "AUGUR_ADDRESS": "0x4200000000000000000000000000000000000006"
      }
    }
  }
}