# AgentScraper API

> AgentScraper API is a freemium MCP server for web search and scraping. Hosted MCP tool that fetches a public web page live and returns 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, Web
- **Website:** https://agentscraper.cc/docs/mcp
- **MCP Registry name:** cc.agentscraper/agentscraper
- **Categories:** web search and scraping, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

The single fetch tool takes five parameters, which is most of what an agent needs to tune. `url` is required (http or https, up to 8,192 characters), `country` is an ISO-3166 code defaulting to us so the page is fetched as seen from another market, and `format` picks markdown, text or html. `max_characters` runs from 500 to 100,000 with a default of 8,000, kept small because the result lands in the agent's context, and `verbosity` switches between main content only and the whole page body.

Each result is one text item with a short header showing the source, country, credits used and credits left, with the full REST-style JSON returned as structured content. A second tool reports plan, credits and rate limit and is free, so an agent can check before a large batch.

AgentScraper uses the same API keys as its REST API, sent as a bearer token to a stateless streamable HTTP endpoint. A successful page costs one credit and failed requests cost nothing.

## Features

- **Country targeting:** Fetches pages as seen from a chosen country, defaulting to the US.
- **Three output formats:** Returns Markdown by default, or plain text or HTML on request.
- **Context-aware limits:** Output is capped at 8,000 characters by default, adjustable from 500 to 100,000.
- **Compact or full view:** Choose main content only or the whole page body.
- **Structured result:** Adds REST-style JSON alongside a short text header.
- **Credit check tool:** Free account status call shows credits and rate limit.

## Good for

- Let an agent read a documentation page during a coding task
- Compare how a page appears to visitors in different countries
- Pull article text into a research workflow as clean Markdown
- Check remaining credits before running a large crawl

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentscraper https://agentscraper.cc/mcp
```

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

```sh
https://agentscraper.cc/mcp
```

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

```json
{
  "mcpServers": {
    "agentscraper": {
      "url": "https://agentscraper.cc/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "agentscraper": {
      "type": "http",
      "url": "https://agentscraper.cc/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentscraper": {
      "serverUrl": "https://agentscraper.cc/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentscraper": {
      "type": "http",
      "url": "https://agentscraper.cc/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 AgentScraper API account. Use before large batches of fetches.

## FAQ

### What does the country parameter do?

It fetches the page as seen from that country, for example de, gb or us, with us as the default.

### How long can returned content be?

Between 500 and 100,000 characters; the MCP default is 8,000.

### Are failed fetches charged?

No. The site says failed requests, including access denied by the site, are free.

### How do I authenticate?

Use the same API key as the REST API, sent as a bearer token.

### Is AgentScraper API free?

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

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

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

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

The closest alternatives to AgentScraper API are Scrapling MCP Server, Firecrawl MCP Server, Claude Code Ultimate Guide, SearXNG Search and NeuralVerge.

## 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.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [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.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.

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