MCP Server

NanoParse MCP

io.github.nanoparse-dev/nanoparse-mcp
Knowledge & Documentation Search & Research Public & reachable MCP 2026-07-28

What this MCP does

Fetches web pages and converts them to clean Markdown with source authority, freshness, and structural trust signals.

nanoparse_fetch
Fetch a URL and return clean Markdown with Litmus (source authority, freshness, structural trust). First 10 free parses per network (subnet), then $0.01 per request via x402 micropayment — when the tool returns a payment_required error, sign the included payment_terms and retry with the payment_signature argument (works in every MCP client; no custom headers needed).
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The URL to fetch and parse'}, 'payment_signature': {'type': 'string', 'description': 'x402 payment signature — base64-encoded JSON payment terms. Only needed after the free tier is exhausted: the payment_required error response includes the payment_terms to sign. Pass the signed terms here (or as a Payment-Signature header if your client supports headers).'}}}
Output schema
{'type': 'object', 'required': ['content'], 'properties': {'content': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'text'], 'properties': {'text': {'type': 'string', 'description': 'The extracted page content as clean Markdown with GFM tables preserved'}, 'type': {'enum': ['text'], 'type': 'string', 'description': "Content type — always 'text' for NanoParse"}}}, 'description': 'Array of content items returned by the tool'}}, 'description': 'Returns content[0].text as clean Markdown with GFM tables, stripped of navigation, ads, and boilerplate. structuredContent carries the full parse envelope: {markdown, metadata, litmus}. On error, returns a JSON-RPC error object with code and message.'}
nanoparse_status
Check wallet balance, USDC balance, quota state, and whether the next /fetch call will succeed without payment. Use before spending — tells the agent exactly how much to fund.
Input schema
{'type': 'object', 'properties': {'address': {'type': 'string', 'description': 'The Ethereum wallet address to query (0x...).'}}}
Output schema
{'type': 'object', 'required': ['wallet_address', 'usdc_balance', 'price_per_parse', 'quota'], 'properties': {'quota': {'type': 'object'}, 'funding_uri': {'type': 'string'}, 'usdc_balance': {'type': 'string'}, 'balance_error': {'type': ['string', 'null']}, 'balance_known': {'type': 'boolean'}, 'wallet_address': {'type': 'string'}, 'price_per_parse': {'type': 'string'}, 'usdc_balance_raw': {'type': ['string', 'null'], 'description': 'Balance in micro-USDC; null when the chain could not be read'}, 'next_call_will_succeed': {'type': ['boolean', 'null'], 'description': 'null when the free tier is exhausted and the balance is unknown'}, 'estimated_parses_remaining': {'type': ['number', 'null'], 'description': 'null when the balance is unknown — never 0, which would imply an empty wallet'}}, 'description': 'Machine-readable status fields. This schema describes structuredContent — strict MCP clients validate structuredContent against it, so it must NOT require the result-envelope `content` array.'}
Changed
nanoparse_status
Oct. 5, 2026, 2:48 a.m.
Added
nanoparse_status
Sept. 17, 2026, 12:45 p.m.
Added
nanoparse_fetch
Sept. 17, 2026, 12:45 p.m.