Web Refinery MCP Server

MCP server that gives AI assistants the ability to extract clean content from any URL via the Web Refinery API. Payments are handled automatically using x402 USDC on Base.

Tools

| Tool | Cost | Description | |------|------|-------------| | web_refinery_basic | $0.003 USDC | Title, markdown content, word count, reading time | | web_refinery_structured | $0.005 USDC | Full metadata: author, date, language, site name, etc. |

Setup

cd mcp-server
npm install

You need a wallet with Base mainnet ETH (gas) and USDC (payment).

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "web-refinery": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "web-refinery": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "web-refinery": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | EVM_PRIVATE_KEY | Yes | — | 0x-prefixed private key with Base USDC | | WEB_REFINERY_URL | No | Production URL | API base URL override |

How It Works

1. AI assistant calls web_refinery_basic or web_refinery_structured with a URL
2. MCP server sends request to Web Refinery API
3. API returns HTTP 402 with x402 payment requirements
4. @x402/axios automatically signs a USDC payment and retries
5. Clean article content is returned to the assistant