NodeProxy Web Surface Markdown Parser

io.github.pgalyen1987Published by GitHub account pgalyen1987v1.1.2Updated Oct 25, 2026

x402 MCP web parser: URLs to Markdown for agents. USDC on Base, Polygon, Arbitrum, Ethereum.

The publisher's own server: Parser Club

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBrowser Automation

Overview

AI-generated overview

A paid web-to-Markdown parser MCP server that fetches public URLs and returns clean, compressed Markdown for an assistant's context.

What you can do
Fetch a public URL and get compressed semantic Markdown with scripts, ads and navigation stripped, for ordinary pages at a low per-call price. Fetch JavaScript-heavy or SPA pages through a hardened headless browser with a realistic profile, returning fully rendered Markdown at a higher per-call price. Both tiers are aimed at keeping retrieval loops cheap on token-heavy sites.
When to use it
Useful when an assistant needs readable page content rather than raw HTML, especially for React or Vue sites that would burn context, or when a basic fetch is blocked by light bot checks and a rendered version is needed.
Requirements
Runs as a remote streamable HTTP endpoint or as a local process via the nodeproxy-tools PyPI package or the @nodeproxy/langchain npm package over stdio. Calls are paid: USDC on Base, Polygon, Arbitrum or Ethereum through x402, or Stripe card payment on the standard tier. A payment-capable client wallet is needed; the README's LangChain example uses an EVM private key environment variable.
Before you install
Every call costs money: $0.002 USDC for the standard parser and $0.05 USDC for the stealth parser, with a $0.50 card minimum on the standard tier. Payment signing may require a private key or wallet credentials, so use a dedicated low-balance wallet. The stealth tier uses proxy rotation and optional CAPTCHA solving, which may conflict with site terms. Fetched URLs are sent to a third-party service.

Installation

In SourceWeft

  1. Open NodeProxy Web Surface Markdown Parser in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.pgalyen1987%2Fnodeproxy/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "nodeproxy-web-surface-markdown-parser": {
      "type": "http",
      "url": "https://nodeproxy-production.up.railway.app/mcp"
    }
  }
}

README

NodeProxy

Self-discoverable MCP utility for autonomous agents — no ads, no landing page, no human in the loop.

NodeProxy exposes two paid tools:

ToolEndpointPriceUse case
surface_markdown_parserPOST /mcp/execute$0.002 USDCNormal public pages
stealth_markdown_parserPOST /stealth-scrape$0.05 USDCCloudflare/Akamai-protected sites

Both fetch a public URL, strip scripts/ads/nav noise, and return compressed Markdown optimized for LLM context windows. Standard tier also accepts Stripe MPP card payments ($0.50 minimum) alongside x402 USDC.

Agents find this service through MCP registries, x402 Bazaar discovery, and machine-readable manifests — not marketing.

Why agents need this

Heavy React/Vue sites burn tokens when agents ingest raw HTML. NodeProxy returns clean Markdown so autonomous retrieval loops stay cheap and accurate. When basic fetch hits bot walls, the stealth tier escalates with proxy rotation, hardened Playwright, and optional CAPTCHA solving.

Architecture

Autonomous Agent    │  search MCP registry / Bazaar (vector or keyword)    ▼GET /mcp/tools  or  MCP list_tools    │  reads JSON schema ("Machine UI")    ▼POST /mcp/execute  or  POST /stealth-scrape    │  no payment → 402 + PAYMENT-REQUIRED (+ Bazaar extension)    │  x402 PAYMENT-SIGNATURE or MPP Authorization: Payment …    │  facilitator verify/settle → parse URL    ▼Markdown payload → agent continues task

Quick start

bash
cd NodeProxycp .env.example .env# Set WALLET_ADDRESS to your Base walletnpm installnpm run dev

Endpoints (replace host with your deploy URL):

EndpointPurpose
GET /healthService status, pricing, stealth/MPP config
GET /mcp/toolsTool catalog for registry crawlers
POST /mcp/executeStandard parse + x402/MPP gate
POST /stealth-scrapeStealth parse + x402 gate
ALL /mcpStreamable HTTP MCP transport
GET /.well-known/mcp.jsonWell-known MCP discovery
GET /.well-known/x402.jsonx402 + Bazaar discovery manifest
GET /.well-known/mpp.jsonMPP Stripe manifest (when configured)
GET /discovery/agent.jsonAgent discovery card
GET /registry/server.jsonLive registry manifest (dynamic)

Environment

VariableDefaultDescription
WALLET_ADDRESS—USDC recipient (your revenue)
PRICE_USDC0.002Standard tier price per parse
STEALTH_PRICE_USDC0.05Stealth tier price per parse
X402_NETWORKeip155:84532Primary network; use eip155:8453 on mainnet
X402_NETWORKSCDP bundleComma-separated CAIP-2 ids (Base, Polygon, Arbitrum, optional Ethereum L1)
FACILITATOR_URLhttps://x402.org/facilitatorx402 facilitator
CDP_API_KEY_ID / CDP_API_KEY_SECRET—Coinbase CDP facilitator (mainnet)
MPP_SECRET_KEY / STRIPE_SECRET_KEY—Stripe MPP on /mcp/execute
STEALTH_PROXY_URLS—Comma-separated proxy URLs for stealth tier
CAPTCHA_SOLVER_KEY—2captcha API key (optional)
PUBLIC_URLlocalhostUsed in discovery manifests

Machine discovery (zero advertising)

  1. Deploy to Railway or any HTTPS host.
  2. Verify live manifests: /mcp/tools, /.well-known/x402.json, /registry/server.json.
  3. Submit PR to the open-source MCP Registry using integrations/mcp-registry/server-entry.json.
  4. Bazaar auto-index: after successful x402 settlements through a Bazaar-enabled facilitator, tools appear in the global Bazaar index (Bazaar docs). NodeProxy attaches Bazaar extension metadata on every 402 response.
  5. Enterprise hubs (Google Agent Registry, Anthropic routing): point them at /.well-known/mcp.json or /discovery/agent.json.

Tool descriptions are written for LLM tool-matching, not humans.

Payment rails

RailToolsDestinationAmount
x402 USDCStandard + stealthYour WALLET_ADDRESS$0.002 / $0.05
Stripe MPPStandard onlyStripe account balance$0.50/card (SPT minimum)

MCP stdio (Claude Desktop / local agents)

bash
npm run mcp:stdio

Add to Claude Desktop config:

json
{  "mcpServers": {    "nodeproxy": {      "command": "node",      "args": ["--import", "tsx", "/path/to/NodeProxy/src/mcp/stdio.ts"],      "env": { "WALLET_ADDRESS": "0x..." }    }  }}

HTTP execute example

bash
# Stage A — get 402 challenge (includes Bazaar extension in PAYMENT-REQUIRED)curl -i "http://localhost:4022/mcp/execute" \  -H 'Content-Type: application/json' \  -d '{"arguments":{"url":"https://example.com"}}'
# Stage B — retry with PAYMENT-SIGNATURE from x402 client walletcurl "http://localhost:4022/mcp/execute" \  -H 'Content-Type: application/json' \  -H 'PAYMENT-SIGNATURE: <base64>' \  -d '{"arguments":{"url":"https://example.com"}}'
# Stealth tier (x402 only)curl -i "http://localhost:4022/stealth-scrape" \  -H 'Content-Type: application/json' \  -d '{"arguments":{"url":"https://example.com"}}'

Use @x402/fetch, @x402/mcp, or nodeproxy-tools for automatic payment.

Deploy on Railway

Railway is the recommended host: full Node.js (JSDOM works), no 15s serverless timeout, metered billing when idle.

1. Push to GitHub

bash
cd NodeProxygit init && git add . && git commit -m "NodeProxy MCP x402 parser"git remote add origin https://github.com/YOU/nodeproxy.gitgit push -u origin main

2. Create Railway project

  1. Go to railway.app → New Project → Deploy from GitHub repo
  2. Select your repo — Railway reads railway.toml + nixpacks.toml automatically
  3. Settings → Networking → Generate Domain (gives you *.up.railway.app)

3. Set environment variables

In Railway → Variables:

VariableValue
WALLET_ADDRESSYour Base wallet (USDC recipient)
X402_NETWORKeip155:8453
PRICE_USDC0.002
STEALTH_PRICE_USDC0.05
CDP_API_KEY_ID / CDP_API_KEY_SECRETCoinbase CDP keys (mainnet facilitator)
MPP_SECRET_KEY / STRIPE_SECRET_KEYStripe MPP (optional)
HOST0.0.0.0
MAX_CONCURRENT_PARSES20
RATE_LIMIT_PER_MINUTE120

You do not need to set PORT or PUBLIC_URL — Railway injects PORT, and the app auto-detects RAILWAY_PUBLIC_DOMAIN for discovery manifests.

4. Verify deploy

bash
curl https://YOUR-APP.up.railway.app/healthcurl https://YOUR-APP.up.railway.app/mcp/toolscurl https://YOUR-APP.up.railway.app/.well-known/x402.json

5. Register for agent discovery

Open a PR to the MCP Registry with integrations/mcp-registry/server-entry.json. Agents hit:

  • https://YOUR-APP.up.railway.app/mcp/tools
  • https://YOUR-APP.up.railway.app/.well-known/mcp.json
  • https://YOUR-APP.up.railway.app/.well-known/x402.json

Cost expectation

Railway’s free tier gives $1/month credit after trial — enough for low traffic ($0.30–0.50/mo idle). One paid agent call at $0.002 USDC covers that. Scale to Hobby ($5/mo) when bot traffic grows.

Do not use Vercel/Cloudflare Workers for this service — JSDOM and 25s fetch timeouts exceed edge limits.

Production (Base mainnet)

env
X402_NETWORK=eip155:8453WALLET_ADDRESS=0xYourWalletPRICE_USDC=0.002STEALTH_PRICE_USDC=0.05

USDC on Base: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913

Upstream framework integrations

To get NodeProxy baked into LangChain, CrewAI, and MCP registry discovery:

  • integrations/UPSTREAM.md — fork → PR → merge playbook
  • integrations/python/ — nodeproxy-tools PyPI package + LangChain/CrewAI wrappers
  • integrations/typescript/ — @nodeproxy/langchain npm package
  • integrations/mcp-registry/ — MCP registry PR template

Quick LangChain example:

python
pip install "nodeproxy-tools[x402,langchain]"export EVM_PRIVATE_KEY=0x...
from nodeproxy_tools.langchain import NodeProxyMarkdownTooltool = NodeProxyMarkdownTool()markdown = tool.invoke({"url": "https://example.com"})

Naming

NodeProxy is registry-ready: boring, predictable, and reads as infrastructure. Tool names (surface_markdown_parser, stealth_markdown_parser) are chosen so semantic search hits match intent.

License

MIT

Part of Gate402

This service is part of the Gate402 x402 agent-API suite — pay-per-call APIs for AI agents over HTTP 402 (USDC on Base). Use it standalone, through the unified storefront + CDP x402 Bazaar at gate402.app, or as an MCP server: npx -y gate402-mcp.

Source: README.md at commit d28f737

Tools

2

surface_markdown_parser

Web Surface Markdown Parser

Executes fetch on any public URL, strips scripts/ads/nav noise, and returns compressed semantic Markdown optimized for LLM token ingestion. Price: $0.002 USDC per call.

Parametersurlrequired

stealth_markdown_parser

Stealth Anti-Bot Markdown Parser

Hardened headless-browser fetch with full JavaScript/SPA rendering and a realistic browser profile, returning fully rendered Markdown. Best for JavaScript-heavy/SPA pages and light bot checks; not guaranteed against advanced anti-bot walls (e.g. Cloudflare/Akamai). Price: $0.05 USDC per call.

Parametersurlrequired

Version history

1
  1. v1.1.2LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Parser integrations