> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Olostep + Raycast Integration

> Add web scraping, search, crawling, and AI answers to Raycast AI with the official Olostep MCP server

Raycast is the productivity launcher used by developers, operators, and AI power users. With Raycast's native support for the Model Context Protocol (MCP), the **official Olostep MCP server** plugs straight into Raycast AI — giving your launcher live web data tools you can call from AI Chat, Quick AI, and AI Commands with a simple `@olostep` mention.

Olostep is an [official entry in Raycast's MCP registry](https://www.raycast.com/), so you can add it in a couple of clicks — no config files to edit.

## Features

The Olostep MCP Server gives your Raycast AI access to Olostep's core web data capabilities:

<CardGroup cols={2}>
  <Card title="Scrape Website" icon="file-lines">
    Extract content from any single URL as Markdown, HTML, JSON, or text — with JavaScript rendering and country targeting.
  </Card>

  <Card title="Search Web" icon="magnifying-glass">
    Run a web search and get structured, parser-based results (titles, URLs, snippets).
  </Card>

  <Card title="Answers (AI)" icon="sparkles">
    Ask a natural-language question and get a web-grounded answer with cited sources and optional structured output.
  </Card>

  <Card title="Batch Scrape URLs" icon="layer-group">
    Process up to 10,000 URLs in a single parallel job — ideal for large-scale extraction.
  </Card>

  <Card title="Crawl Websites" icon="spider-web">
    Start from a URL, follow links, and scrape entire sites or sections automatically.
  </Card>

  <Card title="Map Site URLs" icon="map">
    Discover every URL on a site without scraping — perfect for planning a crawl or batch job.
  </Card>
</CardGroup>

## Before you start

* **An Olostep API key:** [get one free](https://olostep.com/dashboard/api-keys), no credit card required. Your first 500 credits are included.
* **Raycast installed**, with [Raycast AI](https://manual.raycast.com/ai) available on your plan. MCP tools run through Raycast AI (AI Chat, Quick AI, and AI Commands).

<Note>
  Olostep supports two connection modes. The **hosted endpoint** (`https://mcp.olostep.com/mcp`) uses an `Authorization: Bearer YOUR_API_KEY` header. The **local stdio** option (`npx -y olostep-mcp`) uses `OLOSTEP_API_KEY` as an environment variable. Pick one — mixing the two auth modes is the most common setup mistake.
</Note>

## Installation

<Steps>
  <Step title="Get your API key">
    Copy your key from the [Olostep dashboard](https://olostep.com/dashboard/api-keys). You'll paste it into Raycast in the next step.
  </Step>

  <Step title="Install Olostep in Raycast (recommended)">
    Because Olostep is an official entry in Raycast's MCP registry, the fastest path is one-click:

    1. Install the **Model Context Protocol Registry** extension from the Raycast Store (search "MCP" or "Model Context Protocol").
    2. Run the **Search Servers** command, search for **Olostep**, and select it.
    3. Choose **Install**, then enter your Olostep API key when prompted.

    Raycast saves the configuration, starts the connection, and loads the tools automatically.
  </Step>

  <Step title="Or add it manually">
    Prefer to set it up yourself? Open Raycast, run **Install MCP Server** (or **Manage MCP Servers → Install New Server**), and fill out the form with these values:

    * **Name:** `olostep`
    * **Transport:** HTTP
    * **URL:** `https://mcp.olostep.com/mcp`
    * **HTTP Header:** `Authorization` → `Bearer YOUR_API_KEY`

    Press **Install MCP Server** (`⌘` / `Ctrl` + `↵`).

    <Accordion title="Prefer a local install? (stdio)">
      Choose **Standard Input/Output** as the transport instead, and use:

      * **Command:** `npx`
      * **Arguments:** `-y olostep-mcp`
      * **Environment:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Requires Node.js 18+ on your machine. If the command relies on something on your `PATH`, restart Raycast after updating your environment variables so the new values are picked up.
    </Accordion>
  </Step>

  <Step title="Verify and start using it">
    Open the **Manage MCP Servers** command — `olostep` should appear as **Running** with its **10 tools**. Then, in AI Chat or Quick AI, type `@olostep` to scope a request to it:

    ```txt theme={null}
    @olostep find the latest pricing on these three competitor pages and summarize it
    ```
  </Step>
</Steps>

## Available tools

In Raycast you invoke tools in natural language — `@`-mention `olostep`, describe what you want, and Raycast AI picks the right tool. The examples below show typical prompts.

### scrape\_website

Extract content from a single URL in Markdown, HTML, JSON, or text. Handles JavaScript-rendered pages and supports country targeting and specialized parsers.

```txt theme={null}
@olostep scrape https://example.com/pricing and give me the clean markdown
```

### search\_web

Run a web search and return structured results for a query.

```txt theme={null}
@olostep search for the latest news on EU AI regulation
```

### answers

Get an AI-generated answer to a question, grounded in real web data and returned with cited sources. Ask for a specific shape to get structured output.

```txt theme={null}
@olostep what are the top 5 competitors to Notion for technical docs? Return name, homepage, and a one-line description, with sources.
```

### batch\_scrape\_urls

Scrape a known list of URLs in one parallel job (up to 10,000). Runs asynchronously and returns a job you retrieve once it completes.

```txt theme={null}
@olostep scrape these 200 product URLs and return the title and price for each as JSON
```

### create\_crawl

Start from a URL, follow its links, and scrape matching pages across a whole site or section. Runs asynchronously.

```txt theme={null}
@olostep crawl https://docs.stripe.com under /docs and summarize each section as markdown
```

### create\_map

List every URL on a site without scraping content — useful for discovery before a crawl or batch job.

```txt theme={null}
@olostep map all the URLs under https://example.com/blog
```

<Note>
  **Batch and crawl run asynchronously.** Each kicks off a job and returns an ID, which Raycast retrieves with its companion tool (`get_batch_results`, `get_crawl_results`). Together with `get_webpage_content` and `get_website_urls`, the server exposes **10 tools** in total. See the [Olostep MCP Server reference](/integrations/mcp-server) for the full list and parameters.
</Note>

## Example workflows

### Quick competitor research

From AI Chat, gather and synthesize web data in one prompt:

```txt theme={null}
@olostep search for the top project management tools in 2026, then use answers
to summarize the 3 most-mentioned ones with their pricing and a source for each.
```

### Turn a page into clean notes

```txt theme={null}
@olostep scrape https://example.com/blog/post and give me a 5-bullet summary
plus the key quotes.
```

### Save it as a reusable AI Command

Once Olostep is connected, you can bake a prompt into a one-press [AI Command](https://manual.raycast.com/ai). For example, create a command named **"Summarize URL"** with the instruction:

```txt theme={null}
Using @olostep, scrape {argument} as markdown and return a 3-paragraph summary
covering what the page is about, the key details, and any pricing.
```

Now you can run it from anywhere in Raycast with a URL and get an instant summary.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Server shows as Running but lists 0 tools">
    Your API key is invalid or rate-limited. Verify it in the [Olostep dashboard](https://olostep.com/dashboard/api-keys). For the hosted endpoint, the header must be exactly `Authorization: Bearer YOUR_API_KEY` — no quotes around the value and no extra spaces.
  </Accordion>

  <Accordion title="Olostep doesn't appear after installing">
    Open **Manage MCP Servers** and check the server's status. If it's in an **Error** state, the details pane shows the full output from the server or transport. Re-check the URL/header (HTTP) or command/env (stdio), then use the **Restart** action.
  </Accordion>

  <Accordion title="Local (stdio) install won't start">
    Make sure Node.js 18+ is installed and on your `PATH`. After installing or changing environment variables, fully restart Raycast so the new values are picked up. On Windows, ensure `npx` resolves in the shell Raycast launches.
  </Accordion>

  <Accordion title="Hosted endpoint won't connect">
    Confirm `https://mcp.olostep.com/mcp` is reachable from your network (corporate proxies and firewalls can block it). If it's blocked, switch to the local stdio install, which connects to `api.olostep.com` instead.
  </Accordion>

  <Accordion title="Tool isn't being used in a response">
    Make sure you `@`-mention `olostep` in the message (in AI Chat or Quick AI), and that the request clearly calls for web data. You can scope a question to the server by typing `@` and selecting it.
  </Accordion>
</AccordionGroup>

## Learn more

<CardGroup cols={2}>
  <Card title="Raycast" icon="link" href="https://www.raycast.com">
    The Raycast launcher
  </Card>

  <Card title="Raycast MCP Manual" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    How Raycast connects and manages MCP servers
  </Card>

  <Card title="Olostep MCP Server" icon="server" href="/integrations/mcp-server">
    Full MCP setup, tool reference, and parameters
  </Card>

  <Card title="MCP Server Repository" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Source, issues, and release notes
  </Card>
</CardGroup>

## Related

<CardGroup cols={2}>
  <Card title="Scrapes API" icon="file-lines" href="/features/scrapes">
    Full reference for the scrape endpoint
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches">
    How batch jobs work and how to retrieve results
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls">
    Crawl configuration and result retrieval
  </Card>

  <Card title="Maps API" icon="map" href="/features/maps">
    URL discovery and filtering options
  </Card>
</CardGroup>

## Get started

Ready to bring live web data into Raycast?

<CardGroup cols={2}>
  <Card title="Get a free API key" icon="key" href="https://olostep.com/dashboard/api-keys">
    Sign up and grab your Olostep API key — 500 credits included
  </Card>

  <Card title="Browse Raycast MCP servers" icon="store" href="https://www.raycast.com">
    Find Olostep and other servers in the Raycast MCP registry
  </Card>
</CardGroup>

Connect Olostep with Raycast and put web scraping, search, and crawling one `@olostep` mention away.