Piloterr

com.piloterrPublished by piloterr.comOfficial publisherv0.1.0Updated Nov 7, 2026

Scrape 300+ websites (Amazon, LinkedIn, Google, Zillow, Crunchbase…) as structured JSON with one AP…

VerifiedStreamable HTTPWeb executableWeb Search & Scraping Data & Analytics

Server details

Identifier: com.piloterr/mcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 7, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to piloterr.com, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.piloterr%2Fmcp.svg)](https://sourceweft.com/mcp/com.piloterr%2Fmcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Official Piloterr MCP server that lets an assistant scrape 300+ websites as structured JSON through a searchable catalog of API endpoints.

What you can do: Search the catalog of 391 Piloterr scraping endpoints by site or data need
Inspect one endpoint's parameters before calling it
Call an endpoint and get structured JSON, inline images or embedded files back
Check API usage and remaining credits
When to use it: Useful when you want an assistant to pull structured data from sites such as Amazon, LinkedIn, Google, Zillow or Crunchbase without building your own scrapers, and you already have or are willing to buy Piloterr API credits.
Requirements: A Piloterr API key, sent as the x-api-key header on the hosted endpoint or set as PILOTERR_API_KEY for the local npm package. The local option needs Node.js 20 or newer; the hosted server needs nothing installed. Network access to Piloterr.

Before you install

Every endpoint call consumes paid API credits, so usage and remaining credits should be checked. The API key is a secret passed by header or environment variable. Scraped website content is untrusted and may contain injected instructions. Self-hosted HTTP mode should sit behind TLS before exposure.

Installation

In SourceWeft

Open Piloterr in the dashboard and add it to a workspace.
Connect the required credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.piloterr%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

Piloterr MCP Server

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).

Requirements

Node.js 20 or newer
a Piloterr API key — sign up, then copy it from the dashboard

Hosted server (recommended)

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"

claude mcp add --transport http piloterr https://mcp.piloterr.com/ --header "x-api-key: YOUR_API_KEY"

json

{  "mcpServers": {    "piloterr": {      "url": "https://mcp.piloterr.com/",      "headers": {        "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.

Run it locally

Claude Code

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

json

{  "mcpServers": {    "piloterr": {      "command": "npx",      "args": ["-y", "@piloterr/mcp"],      "env": {        "PILOTERR_API_KEY": "YOUR_API_KEY"      }    }  }}

{  "mcpServers": {    "piloterr": {      "command": "npx",      "args": ["-y", "@piloterr/mcp"],      "env": {        "PILOTERR_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json

{  "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    }  ]}

{  "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    }  ]}

Claude Desktop extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

Tools

Piloterr 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.

Streamable HTTP

The 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: [] }) };

import { createHttpHandler } from "@piloterr/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

The API key is read from PILOTERR_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
See SECURITY.md to report a vulnerability.

Development

Built on the SDK

The server uses the official Node.js SDK (@piloterr/sdk).

All Piloterr SDKs

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`

License

MIT — see LICENSE.

Source: README.md at commit b3370d8

Tools

This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

v0.1.0LatestNov 7, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts