# Piloterr

This MCP server for Claude Code connects an agent to Piloterr’s web data API. It searches available endpoints and returns the results of a chosen call.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: piloterr
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/piloterr/piloterr-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/piloterr

## What it does

Piloterr gives an agent tools to search a catalog of 391 API endpoints, inspect an endpoint’s parameters, and call it. The service covers sites such as Amazon, LinkedIn, Google, Zillow, and Crunchbase. Results come back as JSON; images appear inline, while files such as PDFs are attached as embedded resources up to 4 MB.

Local use requires Node.js 20 or later and a Piloterr API key. Set the key through `PILOTERR_API_KEY`; each API call uses credits. A hosted Piloterr server is also available over HTTP, with the key sent in the `x-api-key` header.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.piloterr.com/`
- Environment variables: `PILOTERR_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e PILOTERR_API_KEY=<PILOTERR_API_KEY> -- npx -y @piloterr/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http piloterr https://mcp.piloterr.com/
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add piloterr --url https://mcp.piloterr.com/
```

2. **Platform CLI**
```bash
codex mcp add piloterr --env PILOTERR_API_KEY=<PILOTERR_API_KEY> -- npx -y @piloterr/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "piloterr": {
            "url": "https://mcp.piloterr.com/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "piloterr": {
            "command": "npx",
            "args": [
                "-y",
                "@piloterr/mcp"
            ],
            "env": {
                "PILOTERR_API_KEY": "<PILOTERR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "piloterr": {
            "type": "http",
            "url": "https://mcp.piloterr.com/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "piloterr": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@piloterr/mcp"
            ],
            "env": {
                "PILOTERR_API_KEY": "<PILOTERR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http piloterr https://mcp.piloterr.com/
```

2. **Platform CLI**
```bash
gemini mcp add -e PILOTERR_API_KEY=<PILOTERR_API_KEY> piloterr npx -y @piloterr/mcp
```
Replace <…> with your own values

## When to use it
- find a Piloterr endpoint for a specific website
- inspect an endpoint’s parameters before calling it
- retrieve website data through a selected endpoint

## Example prompts
- Find a Piloterr endpoint for collecting Zillow data and show its parameters.
- Call a suitable Piloterr endpoint to search LinkedIn.
- Show my Piloterr credit usage and remaining balance.

## Similar
- [firecrawl-build-scrape](https://affpapa.org/en/nevibecode/skills/firecrawl-build-scrape.md) — skill · 63000 installs
- [firecrawl-alexandria](https://affpapa.org/en/nevibecode/skills/firecrawl-alexandria.md) — skill · 2900 installs
- [venice-augment](https://affpapa.org/en/nevibecode/skills/venice-augment.md) — skill · ★ 176 repo stars
- [exa-mcp](https://affpapa.org/en/nevibecode/mcp/exa-mcp.md) — MCP server · 144 installs
- [ScrapeGraphAI-scrapegraph-mcp](https://affpapa.org/en/nevibecode/mcp/scrapegraphai-scrapegraph-mcp.md) — MCP server · ★ 123 repo stars
- [scrapy-web-scraping](https://affpapa.org/en/nevibecode/skills/scrapy-web-scraping.md) — skill · 2100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
