io.github.Timwal78/aetheris-mcp

@aetheris/mcp-client

x402-gated web scraping MCP server. Pay 0.01 USDC per page on Base. Returns clean Markdown via JSDOM

4 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 1d ago

Works with most clients

Transport:

4 tools

Grade F

Edit this pageView history

Browser Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-timwal78-aetheris-mcp": {
      "args": [
        "-y",
        "@aetheris/mcp-client"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-timwal78-aetheris-mcp)](https://mcppedia.org/s/io-github-timwal78-aetheris-mcp)

Read me

What io.github.Timwal78/aetheris-mcp does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@aetheris/mcp-client' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

48/100across 5 weighted dimensions

How we score →

0255075100

−52

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @aetheris/mcp-client against OSV.dev.

Inventory

Tools (4)

Click any tool to inspect its schema.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Timwal78/aetheris-mcp safe to use?: io.github.Timwal78/aetheris-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.Timwal78/aetheris-mcp?: io.github.Timwal78/aetheris-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Timwal78/aetheris-mcp do?: io.github.Timwal78/aetheris-mcp provides 4 tools: New, USDC_CONTRACT_ADDRESS, MERCHANT_WALLET_ADDRESS, RPC_URL. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Timwal78/aetheris-mcp?: io.github.Timwal78/aetheris-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.Timwal78/aetheris-mcp actively maintained?: io.github.Timwal78/aetheris-mcp is actively maintained — last commit was 1 day ago.

Similar servers

Others in browser / writing

View all →

Puppeteer MCP Server98

Browser automation with Puppeteer for web scraping and testing

87.9k 5

Firecrawl Mcp Server95

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

6.8k 4

Pullmd95

Self-hosted URL- and file-to-Markdown service for humans and AI agents - web pages, documents, images, audio, YouTube. PWA + REST + MCP + Claude Code skill, Reddit-aware, refreshable share links.

194 3

Apify Mcp Server94

The Apify MCP server enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, or any other website using thousands of ready-made scrapers, crawlers, and automation tools available on the Apify Store.

1.5k 1

MCP Security Weekly

Get CVE alerts and security updates for io.github.Timwal78/aetheris-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

🛡️ 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.

⚙️ 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).

Frequently Asked Questions

Is io.github.Timwal78/aetheris-mcp safe to use?

io.github.Timwal78/aetheris-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.Timwal78/aetheris-mcp?

io.github.Timwal78/aetheris-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.Timwal78/aetheris-mcp do?

io.github.Timwal78/aetheris-mcp provides 4 tools: New, USDC_CONTRACT_ADDRESS, MERCHANT_WALLET_ADDRESS, RPC_URL. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.Timwal78/aetheris-mcp?

io.github.Timwal78/aetheris-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.Timwal78/aetheris-mcp actively maintained?

io.github.Timwal78/aetheris-mcp is actively maintained — last commit was 1 day ago.

🛡️ Aetheris-MCP: The x402 Agentic Web Scraper

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)

🚀 One-Click Deployment

This repository is configured with a render.yaml Blueprint.

Fork this repository.
Go to your Render Dashboard.
Click New -> Blueprint.
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.