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

# MCP Overview

> Model Context Protocol (MCP) integration for Claude, GitHub Copilot, Cursor, and other AI assistants. Give your AI tools real-time web search and URL crawling capabilities.

## What is MCP?

The **Model Context Protocol (MCP)** is an open standard that enables AI assistants to connect directly to external tools and data sources. Crawleo provides native MCP support, allowing AI assistants to search the web and crawl URLs without custom integration code.

## MCP Endpoint

```
https://api.crawleo.dev/mcp
```

## Available Tools

When connected via MCP, AI assistants have access to five tools:

<CardGroup cols={3}>
  <Card title="search_web" icon="magnifying-glass">
    Bing-powered web search with auto-crawling. Best for LLM and RAG use cases.

    **Cost:** 10 credits per page of results
  </Card>

  <Card title="google_search" icon="google">
    Google SERP data with knowledge graphs, news, images, places, and shopping.

    **Cost:** 10 credits per request
  </Card>

  <Card title="google_maps" icon="location-dot">
    Search for businesses, places, and landmarks on Google Maps.

    **Cost:** 10 credits per request
  </Card>

  <Card title="crawl_web" icon="spider-web">
    Crawl specific URLs and extract content.

    **Cost:** 1-10 credits per page
  </Card>

  <Card title="headful_browser" icon="browser">
    Premium headed browser crawling with advanced anti-bot evasion. For sites that block standard crawlers.

    **Cost:** 50 credits per URL
  </Card>
</CardGroup>

### Credit Costs for MCP Tools

| Tool                            | Credits Cost           |
| ------------------------------- | ---------------------- |
| `search_web`                    | 10 credits per page    |
| `google_search`                 | 10 credits per request |
| `google_maps`                   | 10 credits per request |
| `crawl_web` (HTTP request)      | 1 credit per URL       |
| `crawl_web` (browser rendering) | 10 credits per URL     |
| `headful_browser`               | 50 credits per URL     |

<Tip>
  The AI will automatically choose the right tool for your request. `headful_browser` is only invoked when a site blocks standard crawling — the AI tries `crawl_web` first to save credits.
</Tip>

<Card title="Credits & Pricing" icon="coins" href="/credits-pricing">
  View full pricing details and subscription plans.
</Card>

## Compatible Platforms

Crawleo MCP works with all major AI assistants and development environments:

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="message" href="/mcp/claude-desktop">
    Anthropic's Claude desktop application.
  </Card>

  <Card title="Cursor IDE" icon="arrow-pointer" href="/mcp/cursor">
    AI-powered code editor.
  </Card>

  <Card title="Windsurf IDE" icon="water" href="/mcp/windsurf">
    Codeium's AI development environment.
  </Card>

  <Card title="GitHub Copilot" icon="github" href="/mcp/github-copilot">
    GitHub's AI pair programmer.
  </Card>
</CardGroup>

## Why Use MCP?

<AccordionGroup>
  <Accordion title="Zero Code Integration" icon="wand-magic-sparkles">
    Connect AI assistants to Crawleo without writing any integration code. Just configure and go.
  </Accordion>

  <Accordion title="Native AI Experience" icon="robot">
    AI assistants can naturally decide when to search the web or crawl pages based on your requests.
  </Accordion>

  <Accordion title="Real-Time Web Access" icon="globe">
    Give your AI assistant access to live web data, not just its training data.
  </Accordion>

  <Accordion title="Privacy-First" icon="shield-check">
    Same strict privacy guarantees as the REST API - no data retention, no training on your data.
  </Accordion>
</AccordionGroup>

## Quick Setup

The basic configuration pattern is the same across all platforms:

```json theme={null}
{
  "mcpServers": {
    "crawleo": {
      "url": "https://api.crawleo.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Select your platform from the navigation to see detailed setup instructions.

## Example Usage

Once configured, you can ask your AI assistant things like:

* *"Search for the latest news about artificial intelligence"*
* *"Crawl this documentation page and summarize it"*
* *"Find and compare pricing from these three websites"*
* *"Research the top Python web frameworks and their features"*

The AI will automatically use Crawleo's tools to fetch real-time web data.

## Video Tutorials

Step-by-step video guides for setting up Crawleo MCP across different platforms:

### IDE Integrations

<AccordionGroup>
  <Accordion title="Cursor IDE" icon="arrow-pointer">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/LX-XGRpspYQ" title="How to Use Crawleo MCP in Cursor IDE (Full Setup Guide)" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="Windsurf IDE" icon="water">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/_WoitzO1eLM" title="Add Crawleo MCP to Windsurf IDE with Free Subscription" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="GitHub Copilot (VS Code)" icon="github">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/JoZuMOwLAj4" title="How to Connect Crawleo MCP to GitHub Copilot in VS Code (Full Setup Guide)" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="Goose IDE" icon="terminal">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/80fGERZd-E0" title="How to Integrate Crawleo MCP Server in Goose IDE" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="Zed IDE" icon="code">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/v2MghPliujo" title="How to Integrate Crawleo MCP Server in Zed IDE" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>
</AccordionGroup>

### AI Assistants

<AccordionGroup>
  <Accordion title="Claude Desktop" icon="message">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/pFNfJaeQSpg" title="Give Claude Live Web Access: Set Up a Search & Crawling MCP Server" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="Antigravity" icon="rocket">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/ybnMVHcbwwc" title="How to Integrate Crawleo MCP Server in Antigravity" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>
</AccordionGroup>

### Tools & Automation

<AccordionGroup>
  <Accordion title="Postman" icon="paper-plane">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/lr1a5zHBEn4" title="How to Integrate Crawleo MCP Server in Postman" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>

  <Accordion title="n8n Workflow" icon="diagram-project">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/E5q8Z_xphoc" title="Connect Crawleo MCP to n8n (Full AI Agent Workflow Guide)" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="MCP.so Listing" icon="link" href="https://mcp.so/server/crawleo-mcp-server/Crawleo">
    View Crawleo on MCP.so directory.
  </Card>

  <Card title="GitHub Examples" icon="github" href="https://github.com/Crawleo">
    Code examples and integrations.
  </Card>
</CardGroup>