Skip to main content
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, 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:

Scrape Website

Extract content from any single URL as Markdown, HTML, JSON, or text — with JavaScript rendering and country targeting.

Search Web

Run a web search and get structured, parser-based results (titles, URLs, snippets).

Answers (AI)

Ask a natural-language question and get a web-grounded answer with cited sources and optional structured output.

Batch Scrape URLs

Process up to 10,000 URLs in a single parallel job — ideal for large-scale extraction.

Crawl Websites

Start from a URL, follow links, and scrape entire sites or sections automatically.

Map Site URLs

Discover every URL on a site without scraping — perfect for planning a crawl or batch job.

​
Before you start

  • An Olostep API key: get one free, no credit card required. Your first 500 credits are included.
  • Raycast installed, with Raycast AI available on your plan. MCP tools run through Raycast AI (AI Chat, Quick AI, and AI Commands).
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.

​
Installation

1

Get your API key

Copy your key from the Olostep dashboard. You’ll paste it into Raycast in the next step.
2

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

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 + ↵).
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.
4

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:
@olostep find the latest pricing on these three competitor pages and summarize it

​
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. 
@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. 
@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. 
@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. 
@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. 
@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. 
@olostep map all the URLs under https://example.com/blog
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 for the full list and parameters.

​
Example workflows

​
Quick competitor research

From AI Chat, gather and synthesize web data in one prompt: 
@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

@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. For example, create a command named “Summarize URL” with the instruction: 
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

Your API key is invalid or rate-limited. Verify it in the Olostep dashboard. For the hosted endpoint, the header must be exactly Authorization: Bearer YOUR_API_KEY — no quotes around the value and no extra spaces.
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.
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.
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.
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.

​
Learn more

Raycast

The Raycast launcher

Raycast MCP Manual

How Raycast connects and manages MCP servers

Olostep MCP Server

Full MCP setup, tool reference, and parameters

MCP Server Repository

Source, issues, and release notes

Scrapes API

Full reference for the scrape endpoint

Batches API

How batch jobs work and how to retrieve results

Crawls API

Crawl configuration and result retrieval

Maps API

URL discovery and filtering options

​
Get started

Ready to bring live web data into Raycast?

Get a free API key

Sign up and grab your Olostep API key — 500 credits included

Browse Raycast MCP servers

Find Olostep and other servers in the Raycast MCP registry
Connect Olostep with Raycast and put web scraping, search, and crawling one @olostep mention away.