Skip to content
Syed Asif edited this page Jun 12, 2026 · 8 revisions

MCP Tools

The server exposes 15 tools across 9 engines, allowing LLMs to choose the right tool for the specific task.

DuckDuckGo Engine (Free, Fast, Raw)

  • web_search: Performs universal web and news searches. Use this for quick, broad discovery. Supports domain-scoped search via the domain parameter (e.g., domain="docs.python.org").
  • fetch_page: Extracts clean, main-content text from a given URL. Supports multiple output formats (txt, json, markdown, html, xml). Ideal for reading articles.

Reddit Engine (Free, Community Signal)

  • reddit_search: Search Reddit via keyless RSS and shreddit enrichment. Excellent for finding community sentiment, real-user experiences, and discussions. Supports subreddit targeting, depth control, and time filters.

Hacker News Engine (Free, Tech Discourse)

  • hackernews_search: Search Hacker News via the Algolia API. Great for developer opinions, startup discussions, and technical news. No API key needed. Supports depth control for comment enrichment.

GitHub Engine (Free, Code Discussions)

  • github_search: Search GitHub Issues and PRs across repositories. Great for bug reports, feature requests, and community sentiment on open-source projects. Optionally uses GITHUB_TOKEN or gh CLI for higher rate limits.
  • get_github_issue: Fetch a full GitHub Issue or PR thread with all comments sorted by reactions. Requires gh CLI installed and authenticated.

Wikipedia Engine (Free, Knowledge Base)

  • wikipedia_search: Search Wikipedia and return full article text with related results. Great for factual, encyclopedic context. No API key needed.

arXiv Engine (Free, Academic Research)

  • arxiv_search: Search arXiv for academic papers by keyword, author, or category. Supports Lucene field prefixes (au:, ti:, abs:, cat:) for targeted searches. No API key needed.

X/Twitter Engine (Requires Cookies)

  • x_search: Search X/Twitter via vendored Bird CLI. Great for real-time discourse, breaking news, and community engagement signals. Requires AUTH_TOKEN and CT0 environment variables from browser cookies.

Groq Engine (Requires API Key)

  • groq_search: AI-powered web search. Two modes: GPT-OSS models for interactive browsing, Compound models for auto-research. Best for deep research and multi-step synthesis.
  • groq_analyze: Visits a URL and interprets its content in a single step. Uses Groq Compound to fetch and analyze in one call.

Developer Tools (Free, No API Key)

  • package_info: Look up a specific package from npm, PyPI, crates.io, or Go modules. Returns version, description, downloads, license, dependencies count, and repository info.
  • package_search: Search packages by keyword across npm, PyPI, crates.io, or Go. Returns ranked list with metadata.
  • translate_error: Parse an error message with auto-detected language/framework, then search Stack Overflow for solutions. Extracts file paths and line numbers from stack traces.
  • compare_tech: Side-by-side technology comparison using GitHub stars, registry versions, download counts, license, and open issues.

Tool Selection Guide

Task Tool
Quick web search web_search
Read an article fetch_page
Community opinions reddit_search or hackernews_search
Code/issue lookup github_search
Full issue/PR thread get_github_issue
Academic papers arxiv_search
Encyclopedia / facts wikipedia_search
Real-time / breaking news x_search
Package info / search package_info / package_search
Debug errors translate_error
Compare technologies compare_tech
Deep research groq_search
URL analysis groq_analyze

Home | Architecture | Development | Configuration

Clone this wiki locally