Skip to content
MCP server

Avo Cado Read

Turn any web page into clean Markdown for agents, paid per call in USDC

Install
Pricing
Paid
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Avo Cado Read

Avo Cado Read is a paid MCP server for web search and scraping. It runs as a hosted remote server, so there is nothing to install locally.

This service fetches a URL and returns the readable article as Markdown, along with title, byline, site name, language, excerpt, word count, the page's links and a flag for whether the result was truncated or came from cache. There is no account or API key; each call is paid with USDC on Base through the x402 protocol.

Over MCP it exposes read_url, which costs $0.003 per call, and a free pricing tool. A failed or refused read is not charged. The plain HTTP version has a /read endpoint at the same price and a /ping connectivity test at $0.001. Calling without payment returns an HTTP 402 with payment instructions.

The service respects robots.txt under the user-agent token AvoCadoReader, does not bypass logins, paywalls or captchas, and refuses private or internal addresses. Fetches time out after 8 seconds, pages are limited to 2 MB and results are cached for an hour.

Install

Run in a terminal

claude mcp add --transport http read https://avocado-read-api.a-347.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://avocado-read-api.a-347.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "read": {
      "url": "https://avocado-read-api.a-347.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "read": {
      "type": "http",
      "url": "https://avocado-read-api.a-347.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "read": {
      "serverUrl": "https://avocado-read-api.a-347.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "read": {
      "type": "http",
      "url": "https://avocado-read-api.a-347.workers.dev/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

read_url
Fetches a URL and returns clean Markdown; $0.003 per call.
pricing
Free tool that reports pricing.

What it does

Clean Markdown output
Returns readable article text rather than raw HTML.
Page metadata
Includes title, byline, site name, language, excerpt and word count.
Link list
Returns link text and URLs found on the page.
x402 payments
Pay per call in USDC on Base with no account.
Polite fetching
Follows robots.txt and refuses private addresses.
Free failures
Refused or failed fetches are never charged.

Good for

  • Give an agent readable text for a web page without ads or markup
  • Extract links from a page for further crawling
  • Summarise an article from its Markdown
  • Let an autonomous agent pay for page reads without signing up

Pricing

Paid

$0.003 per read, paid in USDC on Base via x402

Prices change. Check avocado-read-api.a-347.workers.dev before you buy.

Avo Cado Read FAQ

How much does a read cost?

$0.003 per call, paid in USDC on Base via x402.

Do I need an API key?

No. There is no account or key; payment is made per request.

Are failed fetches charged?

No. 4xx and 5xx responses are never settled.

What are the limits?

An 8 second fetch timeout, 2 MB page size and a one hour cache.

Is Avo Cado Read free?

No. Avo Cado Read is a paid product.

How do I add Avo Cado Read to Claude Code?

Run this command in your terminal: claude mcp add --transport http read https://avocado-read-api.a-347.workers.dev/mcp

What are the best alternatives to Avo Cado Read?

The closest alternatives to Avo Cado Read are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to Avo Cado Read

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce