# pline.ai

> pline.ai is an MCP server for web search and scraping. Scrape, crawl, map and search the web from your MCP client with a pline.ai key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API, macOS, Linux, Windows
- **Repository:** https://github.com/grepsr/pline-api/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.grepsr/pline-api
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-15

## About

This is a small local launcher that sits between an MCP client and the hosted pline.ai API. The scraping backend stays on pline.ai's servers, so there is no orchestrator, browser fetcher, Redis or Temporal to run locally. Each user brings their own API key, sent to the API as an x-api-key header.

It installs through npx as the pline-api package (Node.js 18+, with prebuilt binaries for macOS, Linux and Windows), as a Docker image on GHCR, or from source with Cargo. A scrape remembers its session per host, so a second scrape of the same host reuses it unless a new session is requested. Over stdio, results can be saved to a local folder; otherwise output is clipped at 60,000 characters by default and the truncated fields are listed.

A remote endpoint with Pline sign-in is described as an alternative to pasting keys, and the repository also installs as a Claude Code plugin.

## Features

- **Single-page scrape:** Fetch one page, with session reuse per host.
- **Batch scraping:** Start, check and cancel batch scrape jobs.
- **Site crawling:** Start, check and cancel crawls of a site.
- **URL mapping:** Discover the URLs on a site.
- **Web search:** Run searches through the hosted API.
- **Local file saving:** Over stdio, save outputs or download job artifacts to a local folder.

## Good for

- Pull page content into an assistant's context
- Crawl a documentation site
- List a site's URLs before scraping
- Run large scraping jobs and check their status from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add pline-api --env PLINE_API_KEY='<PLINE_API_KEY>' -- npx -y pline-api
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pline-api": {
      "command": "npx",
      "args": [
        "-y",
        "pline-api"
      ],
      "env": {
        "PLINE_API_KEY": "<PLINE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pline-api": {
      "command": "npx",
      "args": [
        "-y",
        "pline-api"
      ],
      "env": {
        "PLINE_API_KEY": "<PLINE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pline-api": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pline-api"
      ],
      "env": {
        "PLINE_API_KEY": "<PLINE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pline-api": {
      "command": "npx",
      "args": [
        "-y",
        "pline-api"
      ],
      "env": {
        "PLINE_API_KEY": "<PLINE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pline-api": {
      "command": "npx",
      "args": [
        "-y",
        "pline-api"
      ],
      "env": {
        "PLINE_API_KEY": "<PLINE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `scrape`: Scrapes a page through the hosted API.
- `batch_scrape_start`: Starts a batch scrape.
- `batch_scrape_status`: Checks a batch scrape.
- `batch_scrape_cancel`: Cancels a batch scrape.
- `crawl_start`: Starts a crawl.
- `crawl_status`: Checks a crawl.
- `crawl_cancel`: Cancels a crawl.
- `map_site`: Discovers URLs on a site.
- `search`: Searches the web.
- `sessions_list`: Lists remembered host-to-session mappings for the caller.

## FAQ

### Do I need an API key?

Yes, your own pline.ai key, set as PLINE_API_KEY.

### What does it need to run?

Node.js 18 or later for the npx route, Docker for the image, or Rust to build from source.

### Does a scrape run on my machine?

No. The launcher calls the hosted pline.ai API.

### How long can output be?

60,000 characters by default unless saved to a local folder.

### How do I add pline.ai to Claude Code?

Run this command in your terminal: claude mcp add pline-api --env PLINE_API_KEY='<PLINE_API_KEY>' -- npx -y pline-api

### What are the best alternatives to pline.ai?

The closest alternatives to pline.ai are Scrapling MCP Server, Tavily MCP, Oxylabs MCP, apinoa and MTScraper.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Tavily MCP](https://ai-powered.com/mcp/tavily-mcp): Tavily MCP is a freemium MCP server for web search and scraping.
- [Oxylabs MCP](https://ai-powered.com/mcp/oxylabs-mcp): Oxylabs MCP is an MCP server for web search and scraping.
- [apinoa](https://ai-powered.com/mcp/apinoa): apinoa is a paid MCP server for web search and scraping.
- [MTScraper](https://ai-powered.com/mcp/mtscraper): MTScraper is an open-source MCP server for web search and scraping.
- [Geonode MCP Server](https://ai-powered.com/mcp/geonode-mcp-server): Geonode MCP Server is a freemium MCP server for web search and scraping.
- [Reddit MCP Server](https://ai-powered.com/mcp/reddit-mcp-server-2): Reddit MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/pline-ai
