# Perceptlayer

> Perceptlayer is an MCP server for web search and scraping. Structured JSON from 248 websites through three MCP tools and one API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI, vscode
- **Website:** https://docs.perceptlayer.com/ai-agents
- **MCP Registry name:** com.perceptlayer/web-data
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-15

## About

Perceptlayer packages web data as a catalogue of endpoints, and this server lets an agent discover and call them without scraping. The agent searches for an endpoint such as an Airbnb listing, reads its parameters and credit cost, then runs it to get JSON back.

New accounts receive 100 free credits and failed calls are free. Searching endpoints is free; fetching an endpoint spec and calling it use the endpoint's credits. MCP calls follow the same rules as the API, including rate limits, and restricted endpoints require accepting the terms.

Responses over 100,000 characters are cut short, so paging or limit parameters are needed for large results. Browser-based MCP clients are not supported yet.

## Features

- **Endpoint search:** Find an endpoint by site or kind of data, free of charge.
- **Endpoint specs:** Parameters, an example and the credit cost.
- **Run endpoints:** Call an endpoint and receive JSON.
- **Free failed calls:** Failed calls are not charged.
- **Bearer key auth:** One API key across clients.

## Good for

- Let an agent pull listing data from a supported site
- Check an endpoint's cost before running it
- Add live web data to an agent workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http web-data https://api.perceptlayer.com/mcp
```

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

```sh
https://api.perceptlayer.com/mcp
```

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

```json
{
  "mcpServers": {
    "web-data": {
      "url": "https://api.perceptlayer.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "web-data": {
      "type": "http",
      "url": "https://api.perceptlayer.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "web-data": {
      "serverUrl": "https://api.perceptlayer.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "web-data": {
      "type": "http",
      "url": "https://api.perceptlayer.com/mcp"
    }
  }
}
```

## Tools

- `search_endpoints`: Finds endpoints for a site or kind of data
- `get_endpoint`: Lists an endpoint's parameters, example and credit cost
- `call_endpoint`: Runs an endpoint and returns its JSON

## FAQ

### Is there a free tier?

New accounts get 100 free credits.

### Are failed calls billed?

No.

### Is there a response limit?

Responses over 100,000 characters are truncated.

### Does it work in a browser client?

Not yet; use a desktop app, CLI or your own server.

### Is Perceptlayer free?

Perceptlayer is a paid product with a free trial.

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

Run this command in your terminal: claude mcp add --transport http web-data https://api.perceptlayer.com/mcp

### What are the best alternatives to Perceptlayer?

The closest alternatives to Perceptlayer 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/perceptlayer
