Perceptlayer
Live web data API for developers and AI agents: 248 websites, one key, structured JSON, 1 credit per call, failed calls free.
Hosted MCP Server
npx add-mcp 'https://api.perceptlayer.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Perceptlayer MCP server
Live web data for AI agents. One API key, structured JSON from 248 websites (1,659 endpoints): Google Maps, Zillow, Indeed, Airbnb, Booking.com, Google Search and more.
This is a hosted (remote) MCP server. There is nothing to install: point your client at the URL.
https://api.perceptlayer.com/mcp
Transport: Streamable HTTP. Auth: Authorization: Bearer sk_live_...
(get a free key, 1,000 credits a month, no card).
Tools
| Tool | What it does | Cost |
|---|---|---|
search_endpoints | Finds endpoints for a site or kind of data, such as "airbnb listing". | Free, no key |
get_endpoint | Lists one endpoint's parameters, with an example and its credit cost. | Free, no key |
call_endpoint | Runs an endpoint and returns its JSON. | The endpoint's credits |
The agent searches the catalogue instead of loading 1,659 tool definitions into its context.
Connect a client
Claude Code
claude mcp add --transport http perceptlayer https://api.perceptlayer.com/mcp \
--header "Authorization: Bearer $PERCEPTLAYER_API_KEY"
Cursor: examples/cursor-mcp.json in ~/.cursor/mcp.json.
VS Code: examples/vscode-mcp.json in .vscode/mcp.json.
VS Code asks for the key once and stores it.
Claude Desktop and other stdio-only clients: examples/claude-desktop.json,
which bridges through mcp-remote.
Any other client that supports remote MCP servers needs the same URL and header. Browser-based MCP clients aren't supported yet.
What you can get
| Area | Sources |
|---|---|
| Real estate | 54 |
| Cars | 39 |
| Social (additional terms) | 39 |
| Marketplaces | 27 |
| Travel | 26 |
| Search | 26 |
| Jobs | 13 |
| Reviews | 9 |
| Apps | 8 |
| Web and SEO | 7 |
Full catalogue: perceptlayer.com/apis.
Pricing
- 1 credit per successful call. Failed calls (invalid parameters, no data, rate limits, source outages) cost nothing.
- Free: 1,000 credits a month, 1 request a second.
- Prepaid packs from $15 for 10,000 credits, down to $0.60 per 1,000 calls. No subscription; credits last 12 months.
Details: perceptlayer.com/pricing.
Limits
- Calls through MCP follow the API's rules: rate limits apply and restricted endpoints need the terms.
- Responses longer than 100,000 characters are cut short; use an endpoint's paging or limit parameters.
Links
- Docs: docs.perceptlayer.com/ai-agents
- REST API reference: docs.perceptlayer.com
- MCP Registry manifest:
server.json - Support: support@perceptlayer.com
The server itself is closed source; this repository holds its public listing, client configs and registry manifest under the MIT license.