Perceptlayer MCP
An official MCP server provided by Perceptlayer that allows AI agents to access structured JSON data from 248 websites, including Google Maps, Zillow, and Airbnb, using a single API key for search and endpoint execution.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.perceptlayer.com/mcpWhat you can do with it
- Search for local business listings and reviews
- Retrieve real estate property details and prices
- Find job advertisements and company information
- Check product availability and pricing on marketplaces
Source and maintenance
Protocol and capabilities
- Server
- Perceptlayer 1.1.0
- MCP protocol
- 2025-06-18
- Tools
- 3 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
3 advertised
search_endpoints — Search data endpoints
Find Perceptlayer endpoints for a website or kind of data. The catalogue has 1659 endpoints across 248 sources, so search before calling. Query with the site and the data you want, e.g. "amazon product reviews", "airbnb listing", "linkedin company", "google maps places", "zillow property". Returns compact matches: endpoint ID (pass it to get_endpoint or call_endpoint), name, HTTP method, credits per call, tier ("restricted" endpoints need the account's restricted-endpoint terms accepted) and required parameters. Free; no API key needed.
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results (default 10)."
},
"query": {
"type": "string",
"description": "Site and/or data wanted, in a few words, e.g. \"tripadvisor hotel reviews\"."
},
"vertical": {
"enum": [
"apps",
"cars",
"jobs",
"marketplaces",
"real-estate",
"reviews",
"search",
"social",
"travel",
"web-seo"
],
"type": "string",
"description": "Optional: only return endpoints in this vertical."
}
},
"additionalProperties": false
}{
"title": "Search data endpoints",
"readOnlyHint": true,
"openWorldHint": false
}get_endpoint — Get endpoint details
Get the full parameter list for one endpoint: each parameter's name, type, whether it is required, allowed values and limits, plus an example set of parameters, the credit cost and tier. Call this before call_endpoint unless you already know the parameters. Free; no API key needed.
{
"type": "object",
"required": [
"endpoint"
],
"properties": {
"endpoint": {
"type": "string",
"description": "Endpoint ID from search_endpoints, e.g. \"airbnb.listing\"."
}
},
"additionalProperties": false
}{
"title": "Get endpoint details",
"readOnlyHint": true,
"openWorldHint": false
}call_endpoint — Call a data endpoint
Run one endpoint and return its JSON response. Spends the endpoint's credits from the user's balance on success only; failed calls are free. Pass parameters exactly as get_endpoint lists them (array parameters as JSON arrays). The result reports credits used and remaining. Errors come back with a code: invalid_parameters (fix the parameters and retry), not_found (no data for these parameters), rate_limited or temporarily_unavailable (wait and retry), insufficient_credits, restricted_endpoint (the user must accept the restricted-endpoint terms in their dashboard), invalid_api_key (the MCP server config needs a valid API key). Responses over 100,000 characters are truncated; use paging or limit parameters to fetch less.
{
"type": "object",
"required": [
"endpoint"
],
"properties": {
"params": {
"type": "object",
"description": "Parameters for the endpoint, e.g. {\"listing_id\": \"18648717\"}.",
"additionalProperties": true
},
"endpoint": {
"type": "string",
"description": "Endpoint ID from search_endpoints, e.g. \"airbnb.listing\"."
}
},
"additionalProperties": false
}{
"title": "Call a data endpoint",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 246 ms
- 95th percentile latency
- 246 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 246 ms · metadata changed · 3 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http perceptlayer-mcp https://api.perceptlayer.com/mcpCodex
codex mcp add perceptlayer-mcp --url https://api.perceptlayer.com/mcpCursor
{
"mcpServers": {
"perceptlayer-mcp": {
"url": "https://api.perceptlayer.com/mcp"
}
}
}Cline
{
"mcpServers": {
"perceptlayer-mcp": {
"type": "streamableHttp",
"url": "https://api.perceptlayer.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"perceptlayer-mcp": {
"type": "http",
"url": "https://api.perceptlayer.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http perceptlayer-mcp https://api.perceptlayer.com/mcpClaude Desktop
{
"mcpServers": {
"perceptlayer-mcp": {
"url": "https://api.perceptlayer.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"perceptlayer-mcp": {
"serverUrl": "https://api.perceptlayer.com/mcp"
}
}
}Let your agent find its tools
Find servers like Perceptlayer MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Perceptlayer MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.