# Piloterr

> Piloterr is a freemium MCP server for web search and scraping. Search, inspect and call 391 scraping endpoints through four small MCP tools. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://www.piloterr.com
- **Repository:** https://github.com/piloterr/piloterr-mcp
- **MCP Registry name:** com.piloterr/mcp
- **Categories:** web search and scraping, analytics and data
- **Listing updated:** 2026-11-14

## About

Loading hundreds of endpoints as separate tools would swamp a model's context, so this server exposes a catalogue instead. The model searches the endpoints, reads one endpoint's parameters, then calls it. The README counts 391 endpoints; the registry entry describes 300+ sites including Amazon, LinkedIn, Google, Zillow and Crunchbase returned as structured JSON.

The vendor's site describes proxy rotation, headless Chrome rendering and anti-bot handling as part of the service, with JSON, Markdown or custom-field extraction, and SDKs for Node.js, Python, Go, PHP, .NET, Ruby, Java and a CLI. Every tool that calls the API consumes credits; images return inline and files up to 4 MB come back as embedded resources.

Web content is treated as untrusted data, and keys are stripped from error messages. Use the hosted endpoint with an `x-api-key` header or `@piloterr/mcp` over stdio.

## Features

- **Endpoint catalogue:** Search 391 endpoints rather than loading each as a tool.
- **Parameter lookup:** Describe one endpoint's inputs before calling it.
- **Structured output:** Scraped pages return as JSON, with images and small files inline.
- **Credit tracking:** A usage tool shows remaining credits.
- **Key safety:** API keys are removed from error messages.

## Good for

- Pull SERP or product data into a chat
- Enrich company or profile records
- Monitor listings and prices on marketplaces
- Prototype a scraper by browsing endpoints first

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.piloterr.com/
```

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

```sh
https://mcp.piloterr.com/
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.piloterr.com/"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.piloterr.com/"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.piloterr.com/"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.piloterr.com/"
    }
  }
}
```

## Tools

- `search_endpoints`: Search the 391 Piloterr endpoints.
- `get_endpoint`: Describe one endpoint's parameters.
- `call_endpoint`: Call an endpoint and return the result.
- `usage`: API usage and remaining credits.

## FAQ

### How many endpoints are there?

The README says 391 endpoints, available through search_endpoints.

### Why only four tools?

To avoid overloading the client; the model discovers endpoints on demand.

### Is there a free start?

The site mentions starting free with 500 credits.

### How do I authenticate?

Pass PILOTERR_API_KEY locally or an x-api-key header on the hosted server.

### Is Piloterr free?

Piloterr has a free plan, with paid plans for more usage or features.

### How do I add Piloterr to Claude Code?

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

### What are the best alternatives to Piloterr?

The closest alternatives to Piloterr are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

## 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.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/piloterr
