🛡️ Aetheris-MCP: The x402 Agentic Web Scraper

Aetheris-MCP is an enterprise-grade Server-Sent Events (SSE) Model Context Protocol server. It provides AI Agents with high-fidelity, ad-free Markdown web scraping capabilities, protected by an on-chain x402 Micropayment Interceptor.

Bring Your Own Key (BYOK) for inference. Settle in USDC on Base for context.

🏗️ Architecture

• Engine: Node.js + Express

• Scraper: JSDOM (Deep DOM sanitization, strips scripts/styles/ads)

• Transport: Server-Sent Events (/sse & /message)

• Monetization: ethers.js (EVM HTTP 402 validation on Base Mainnet)

Related MCP server: WebSurfer MCP

🚀 One-Click Deployment

This repository is configured with a render.yaml Blueprint.

1. Fork this repository.

2. Go to your Render Dashboard.

3. Click New -> Blueprint.

4. Connect the forked repository. Render will automatically detect the configuration and deploy the Express server.

⚙️ Environment Variables

Ensure you set these in your hosting environment:

• REQUIRE_PAYMENT (boolean) - Enforces the 402 interceptor.

• BASE_MICROPAYMENT_COST (float) - USDC cost per scrape (e.g., 0.01).

• USDC_CONTRACT_ADDRESS - The target ERC-20 contract.

• MERCHANT_WALLET_ADDRESS - Your EVM public key.

• RPC_URL - Your Web3 RPC provider (defaults to https://mainnet.base.org).

💻 Client Integration

Agents should NOT connect to this server manually. Use the official Auto-Settlement SDK: npm install @aetheris/mcp-client

See the Client SDK Repository for documentation on how the SDK intercepts the 402 challenge and settles the transaction autonomously.