# MCPScraper API

> MCPScraper API is a freemium MCP server for web search and scraping. MCPScraper API: hosted MCP tool that turns any public URL into Markdown, text or HTML. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** API
- **Website:** https://mcpscraper.net/docs/mcp
- **MCP Registry name:** net.mcpscraper/mcpscraper
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-15

## About

Aimed at agents that need page text rather than a browser, this server returns a page's main content from a single URL and lets the caller choose a country for the request. Pages that need JavaScript rendering are billed at a higher credit rate than static ones, and nothing is charged when a fetch fails.

Two tools are exposed: one for retrieving a page and one for checking credits, plan and rate limit. Each result starts with a short header showing the source, country and credits used, followed by the content. Larger pages can be returned by raising the character cap up to 100,000.

Access uses the same API keys as the REST version, sent as a bearer token to mcpscraper.net/mcp.

## Features

- **Single-URL fetch:** Reads one public http or https page per call and returns its main content.
- **Three output formats:** Returns Markdown by default, or plain text or HTML on request.
- **Geo-targeted requests:** Takes an ISO country code so the page is fetched as seen from that country.
- **Usage header:** Each result states credits used and credits left.
- **Rate-limit visibility:** The status tool reports the account's request rate and plan.

## Good for

- Give an agent read access to public web pages
- Compare how a page looks from different countries
- Convert articles to Markdown for retrieval pipelines
- Monitor credit use during long agent runs

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcpscraper https://mcpscraper.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcpscraper.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcpscraper": {
      "url": "https://mcpscraper.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcpscraper": {
      "type": "http",
      "url": "https://mcpscraper.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcpscraper": {
      "serverUrl": "https://mcpscraper.net/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcpscraper": {
      "type": "http",
      "url": "https://mcpscraper.net/mcp"
    }
  }
}
```

## Tools

- `get_page_contents`: Fetch a public web page live and return its main content as clean Markdown, plain text or HTML. Use this when you have a specific URL and need its current content. Works best on articles, docs, product and listing pages. Does not log in, submit forms or execute JavaScript (yet).
- `get_account_status`: Check the remaining credits, plan and rate limit for the connected MCPScraper API account. Use before large batches of fetches.

## FAQ

### What does a page cost?

One credit for a standard page, three for a JavaScript-rendered page, and nothing for failures.

### Which transport does it use?

Stateless Streamable HTTP over POST; GET and DELETE return 405.

### What happens without a valid key?

Requests are rejected with HTTP 401, or 403 for suspended accounts, before any tool runs.

### Is there a free tier?

A free test gives 250 credits over four weeks, no card needed.

### Is MCPScraper API free?

MCPScraper API has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add MCPScraper API to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcpscraper https://mcpscraper.net/mcp

### What are the best alternatives to MCPScraper API?

The closest alternatives to MCPScraper API are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/mcpscraper-api
