🔥 FireScrape MCP Server

<div align="center">

The Ultimate Gateway for AI Agents. Empower your LLMs to Browse, Search, Research, and Scrape with precision.

Installation • Connection Guides • AI Rules • Tools

</div>

---

🚀 Overview

FireScrape MCP is a Model Context Protocol server designed to bridge the gap between AI models (Claude, Cursor, etc.) and the real world. It provides robust tools for:

• Deep Research: Multi-step autonomous investigation and synthesis.
• Web Access: Anti-blocking search and intelligent markdown scraping.
• Local Context: File system access for project-aware coding.

📦 Installation & Usage

Run instantly without global installation using npx:

npx -y @yutugyutugyutug/firescrape-mcp

✨ Key Features (v1.1.2)

• 🧠 deep_research: Conducts autonomous, multi-step research on complex topics, filtering noise and synthesizing reports.
• 🌐 search_web: High-availability web search with fallback providers (DuckDuckGo + Brave) to ensure you always get results.
• 📄 scrape_webpage: Converts messy HTML into clean, token-efficient Markdown, stripping ads and irrelevant boilerplate.
• 🔍 discover_tools: a "Meta-Tool" to find and install other MCP servers from GitHub and Smithery.
• 📂 Local Integration: Seamlessly list_files and read_file to give your AI context about your local project.

---

🤖 AI Agent Rules

Want your AI to be smarter? We have created a standardized rule set to teach your AI agents (Cursor, Windsurf, Cline) how to effectively use these tools to verify facts and avoid hallucinations.

👉 Read the AI Usage Guidelines

Copy the content of the file above into your .cursorrules or System Prompt to supercharge your agent.

---

🔌 Connection Guides

1. Claude Desktop App

1. Open your configuration file:
   • Windows: Win + R -> %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Add this configuration:

   {
     "mcpServers": {
       "firescrape": {
         "command": "npx",
         "args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
       }
     }
   }
   

2. Cursor (AI Code Editor)

1. Navigate to Settings -> Features -> MCP.
2. Click + Add New MCP Server.
3. Fill in the fields:
   • Name: FireScrape
   • Type: stdio
   • Command: npx
   • Args: -y @yutugyutugyutug/firescrape-mcp
4. Click Add to save.

3. Gemini CLI

1. Locate your config file:
   • Linux/Mac: ~/.gemini/settings.json
   • Windows: %USERPROFILE%\.gemini\settings.json
2. Insert the server configuration:

   {
     "mcpServers": {
       "firescrape": {
         "command": "npx",
         "args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
       }
     }
   }
   

4. Claude Code (CLI)

Run this command in your terminal to add FireScrape:

claude mcp add firescrape -- npx -y @yutugyutugyutug/firescrape-mcp

5. Google Antigravity

1. Open the Manage MCP Servers panel.
2. Select "Edit Configuration" or open mcp_config.json.
3. Add the entry:

   "firescrape": {
     "command": "npx",
     "args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
   }
   

6. Cline (VS Code Extension)

1. Open Cline Settings (in VS Code settings or via the extension menu).
2. Locate the MCP Servers config file (usually via a button "Edit MCP Settings").
3. Add the following:

   {
     "mcpServers": {
       "firescrape": {
         "command": "npx",
         "args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
       }
     }
   }
   

---

🛠️ Tools Reference

Tool Name	Description	Parameters
scrape_webpage	Reads a specific URL and returns structured Markdown.	url (string)
search_web	Finds current info on the web.	query (string)
discover_tools	Finds other MCP servers on GitHub.	query (string)
search_in_page	Searches text inside a specific page URL.	url (string), query (string)
list_files	Lists files in a folder.	path (string, optional)
read_file	Reads a file's content.	path (string)
get_agent_rules	Returns the strict operational protocol for AI agents.	(none)

---

<div align="center"> Built with ❤️ by <a href="https://github.com/aasm3535/firescrape">FireScrape</a> </div>