Supports containerized deployment of the Presearch MCP server with Docker and Docker Compose configurations for easy orchestration.
Uses environment variable configuration for managing API keys, cache settings, and server configuration.
Includes ESLint for code quality and linting during development.
Version control system used for managing the project repository.
Hosts the project repository, issue tracking, and community discussions.
Supports Markdown as an export format for search results and scraped content.
Built on Node.js runtime (requires v20.0.0 or higher) for server execution.
Uses npm for package management and dependency installation.
Includes Prettier for code formatting during development.
Provides Redis-compatible intelligent caching with configurable TTL and key limits for improved performance.
Uses Shields.io badges in documentation for displaying project status and metadata.
๐ Overview
The Presearch MCP Server is a professional-grade integration bridge that connects AI assistants (like Claude, Cursor, and Trae) to the Presearch decentralized search engine.
Unlike traditional search APIs that track user behavior, Presearch offers a decentralized, privacy-centric alternative. This server enables your AI to:
๐ก๏ธ Search Anonymously | ๐ Scrape Intelligently | ๐ง Research Deeply | ๐ Monitor Nodes |
No IP tracking or search history logging | Extract clean content from modern, dynamic websites | Perform multi-step investigations autonomously | Track the status and earnings of Presearch nodes |
๐ฅ Real-World Examples
See what's possible when you give your AI access to Presearch.
1. ๐ง Deep Research Mode
User Prompt: "Research the effects of climate change on coastal real estate markets."
Tool Used: presearch_deep_research
Result: The agent autonomously performs a multi-step investigation:
Initial Search: Queries Presearch for broad market trends.
Analysis: Identifies key sub-topics (insurance rates, flood risk zones, property devaluation).
Deep Dive: Executes targeted sub-searches for each topic.
Synthesis: Returns a comprehensive report citing 14+ distinct sources, including academic papers and market reports, with no tracking of the search intent.
2. โก Search & Scrape (Fast Context)
User Prompt: "Get me the latest specs for the iPhone 16 Pro and summarize the camera upgrades."
Tool Used: presearch_search_and_scrape
Result:
Search: Finds the top 3 most relevant pages (Apple Official, TechCrunch, The Verge).
Scrape: Immediately fetches the full HTML content of all 3 pages in parallel using a headless browser.
Output: Returns 35kb of clean text content.
AI Action: The AI reads the raw specs and generates a perfect summary of the 48MP Ultra Wide camera and 5x Telephoto lens features.
3. ๐ก๏ธ Privacy-First Market Analysis
User Prompt: "Find competitors to our new SaaS product 'StealthMode' without alerting them via analytics."
Tool Used: presearch_ai_search
Result:
Anonymity: The searches are routed through Presearch's decentralized node network. The competitor websites see traffic from generic Presearch nodes, not your corporate IP address.
Outcome: A list of 10 direct competitors launched in the last month, gathered without leaving a digital footprint.
๐ก๏ธ What is Presearch?
Presearch is a decentralized search engine built on blockchain technology that rewards community members with Presearch tokens (PRE) for their usage, contribution to, and promotion of the platform.
Why Presearch Matters for AI
๐ซ Uncensored Access | ๐ Privacy Protection | ๐ Community Infrastructure |
Results are not filtered by central authorities | Your AI's queries are not profiled by ad-tech giants | Search index powered by independent community nodes |
Complete view of the web | Proprietary data remains private | Resilient, distributed control |
๐ก Key Features
๐ก๏ธ Privacy & Security
Decentralized Infrastructure: Leverages Presearch's distributed node network
Bearer Token Auth: Secure, standard authentication for API access
No Data Persistence: The server is stateless; no user queries are stored on disk
๐ง Robust Tooling
Deep Research Mode: Recursive search and analysis capabilities
Smart Scraping: Headless browser integration to scrape dynamic JS-heavy websites
Flexible Input Handling: Tools accept JSON strings and loose types for maximum compatibility with LLMs
Multi-Format Export: Export results to JSON, CSV, Markdown, HTML, or PDF
๐ Enterprise Ready
Intelligent Caching: Configurable TTL and memory limits
Rate Limiting & Retries: Robust error handling with exponential backoff
Health Monitoring: Real-time status checks for API connectivity
๐ ๏ธ Available Tools
Tool Name | Description | Key Parameters |
| Standard web search optimized for AI |
,
,
,
,
|
| Autonomous multi-step research agent |
,
,
,
,
|
| Search and immediately scrape top results |
,
,
,
|
| Scrape content from specific URLs |
,
,
|
| Analyze content quality and relevance |
,
,
|
| Export search results to files |
,
(json/csv/md/html/pdf),
|
| Advanced export with scraping and analysis |
,
,
,
,
|
| Monitor Presearch node health |
,
,
,
|
| View internal cache metrics | (None) |
| Clear the internal cache | (None) |
| Verify API connectivity | (None) |
Note: All tools support robust input parsing. Parameters can be passed as native types (numbers, booleans, arrays) or as strings/JSON strings (e.g.,
"true","10","['url1', 'url2']").
๐ Available Prompts
The server provides built-in prompts to help you get started with common tasks:
Prompt Name | Purpose |
| Conduct deep research on a specific topic |
| Find the latest news about a topic from the last 24 hours |
| Verify a claim or statement with evidence |
| Analyze a market sector or product category |
| Check the status and earnings of your Presearch nodes |
| Research reviews and sentiment for a product |
| Conduct academic research prioritizing .edu and journals |
| Learn how to use a specific tool effectively |
๐ Resources
The server exposes the following resources for configuration and debugging:
Resource URI | Description |
| View current server configuration (secrets masked) |
| Check current API rate limit status |
| List of supported ISO 3166-1 alpha-2 country codes |
| List of supported BCP 47 language codes |
โ๏ธ Configuration
The server can be configured via environment variables or MCP settings.
Environment Variables
Variable | Description | Default |
| Your Presearch API Key (Required) | - |
| API Endpoint URL |
|
| Request timeout in ms |
|
| Logging verbosity (
,
,
) |
|
JSON Configuration Schema
When using Smithery or an MCP client, the configuration object supports:
๐ Quick Start
1. Get an API Key
Sign up at Presearch.io to obtain your API key.
2. Run with npx
3. Deploy via Smithery
Use the button above or run:
๐งช Development
Install Dependencies
Run Tests
Build & Lint
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Step | Action |
1 | Fork the repository |
2 | Create your feature branch (
) |
3 | Commit your changes (
) |
4 | Push to the branch (
) |
5 | Open a Pull Request |
๐ License
MIT ยฉ Presearch MCP Team