# Olostep MCP Server

Olostep MCP Server — an MCP server that gives your agent live web search, site scraping and crawling. Returns data in HTML, Markdown, JSON or plain text.

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

## What it does

Olostep connects your agent to an API for extracting and structuring web data. Ask it to search with a shaped response schema, scrape one page or a batch of up to ten thousand URLs, start an autonomous site crawl from a seed, or map all URLs on a project with include and exclude filters. Search can return answers with citations and conform to your JSON schema.

The server runs remotely at `https://mcp.olostep.com/mcp` (OAuth or API key via `Authorization: Bearer` header) or locally via `npx` and Docker. For JS-heavy sites, you configure render wait time; for geo-targeted content, request routing by country. If a site serves different markup depending on region, you can account for that.

API key comes from olostep.com/auth. Without it, the server will not start.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.olostep.com/mcp`

## Install

### Claude Code (native platform)

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

2. **Platform CLI**
```bash
claude mcp add olostep-mcp-server -- npx -y olostep-mcp
```

### Codex

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

2. **Platform CLI**
```bash
codex mcp add olostep-mcp-server -- npx -y olostep-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "olostep-mcp-server": {
            "url": "https://mcp.olostep.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "olostep-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "olostep-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "olostep-mcp-server": {
            "type": "http",
            "url": "https://mcp.olostep.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "olostep-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "olostep-mcp"
            ]
        }
    }
}
```

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add olostep-mcp-server npx -y olostep-mcp
```

## When to use it
- get structured answers to web search queries
- scrape a page or batch of URLs into Markdown or JSON
- run an autonomous site crawl from a given URL
- map all pages on a project with filters
- extract data from geo-targeted content by country

## Example prompts
- Find the last three articles about MCP servers on the web and return JSON with titles, links and dates
- Scrape olostep.com homepage into Markdown
- Collect all URLs from example.com/blog, exclude pages with `/tag/` in the path

## Similar
- [crawlforge-mcp-server](https://affpapa.org/en/nevibecode/mcp/crawlforge-mcp-server.md) — MCP server · ★ 6 repo stars
- [scrape](https://affpapa.org/en/nevibecode/skills/brightdata-scrape.md) — skill · 11100 installs
- [Octocrawl](https://affpapa.org/en/nevibecode/mcp/octocrawl.md) — MCP server · ★ 7 repo stars
- [MarkUDown](https://affpapa.org/en/nevibecode/mcp/markudown.md) — MCP server · ★ 16 repo stars
- [firecrawl](https://affpapa.org/en/nevibecode/skills/firecrawl.md) — skill · 104500 installs
- [exa](https://affpapa.org/en/nevibecode/mcp/exa.md) — MCP server · ★ 5254 repo stars

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