
Official MCP server for the Piloterr web scraping API.
Official MCP server for the Piloterr web scraping API.
·
Official Model Context Protocol server for the Piloterr web scraping API.
Scrape 300+ websites (Amazon, LinkedIn, Google, Zillow, Crunchbase…) as structured JSON with one API.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
Piloterr runs this server for you at https://mcp.piloterr.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http piloterr https://mcp.piloterr.com/ --header "x-api-key: YOUR_API_KEY"{
"mcpServers": {
"piloterr": {
"url": "https://mcp.piloterr.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
claude mcp add piloterr --env PILOTERR_API_KEY=YOUR_API_KEY -- npx -y @piloterr/mcpAdd the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"piloterr": {
"command": "npx",
"args": ["-y", "@piloterr/mcp"],
"env": {
"PILOTERR_API_KEY": "YOUR_API_KEY"
}
}
}
}{
"servers": {
"piloterr": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@piloterr/mcp"],
"env": {
"PILOTERR_API_KEY": "${input:piloterr-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "piloterr-api-key",
"description": "Piloterr API key",
"password": true
}
]
}Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
docker build -t piloterr-mcp .
docker run -i --rm -e PILOTERR_API_KEY=YOUR_API_KEY piloterr-mcpPiloterr has 391 endpoints, more than a client should load as separate tools. The server exposes a small catalog instead: the model searches it, reads an endpoint's parameters, then calls it.
| Tool | Description |
|---|---|
search_endpoints | Search the 391 Piloterr endpoints. |
get_endpoint | Describe the parameters of one endpoint. |
call_endpoint | Call one Piloterr endpoint and return the result. |
usage | Show API usage and remaining credits. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
npx @piloterr/mcp --http --port 3000The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@piloterr/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };PILOTERR_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.jsThe server uses the official Node.js SDK (@piloterr/sdk).
| SDK | Package | Install |
|---|---|---|
| Node.js | @piloterr/sdk | npm install @piloterr/sdk |
| Python | piloterr | pip install piloterr |
| Go | piloterr-go | go get github.com/piloterr/piloterr-go |
| .NET | Piloterr | dotnet add package Piloterr |
| Ruby | piloterr | gem install piloterr |
| PHP | piloterr/sdk | composer require piloterr/sdk |
| Java | piloterr-java | build from source, see its README |
| CLI | @piloterr/cli | npm install -g @piloterr/cli |
| MCP server | @piloterr/mcp | npx -y @piloterr/mcp |
MIT — see LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add piloterr --transport http https://mcp.piloterr.com/{
"mcpServers": {
"piloterr": {
"url": "https://mcp.piloterr.com/",
"headers": {
"x-api-key": ""
}
}
}
}code --add-mcp '{"name":"piloterr","url":"https://mcp.piloterr.com/","headers":{"x-api-key":""}}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/piloterr-mcp-server to learn what the "Piloterr MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http piloterr https://mcp.piloterr.com/ --header "x-api-key: YOUR_API_KEY"
claude mcp add piloterr --env PILOTERR_API_KEY=YOUR_API_KEY -- npx -y @piloterr/mcpdocker run -i --rm -e PILOTERR_API_KEY=YOUR_API_KEY piloterr-mcpnpx @piloterr/mcp --http --port 3000
npx @modelcontextprotocol/inspector node dist/stdio.jsThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/piloterr-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "piloterr-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.