English Français العربية

Grounder

السجل الرسمي البحث والويب

Web grounding for local & cloud LLMs: search, fetch, token-capped evidence packs, and research.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package grounder-mcp
Claude Code 
claude mcp add grounder -e 'GROUNDER_API_KEY=<your grounder_api_key>' -- uvx grounder-mcp==0.4.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "grounder": {
            "command": "uvx",
            "args": [
                "grounder-mcp==0.4.1"
            ],
            "env": {
                "GROUNDER_API_KEY": "<your grounder_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • GROUNDER_API_KEY إلزامي سري Your Grounder API key - get one free at https://grounder.dev

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Grounder MCP
  2. Install
  3. Configure
  4. The four tools
  5. Why use it
  6. Pricing

Grounder MCP

Live web grounding for local and cloud LLMs, as four MCP tools. Every model is frozen at its training cutoff; Grounder gives yours the current web - ranked results, real page content, and a cited evidence pack sized to your context window.

A thin stdio client for the hosted service at https://grounder.dev - no browser, no scraper, nothing heavy runs locally. It runs with no signup on a shared demo key; add your own free key (1,500 pages/month, no card) at grounder.dev for real use.

Install

uvx grounder-mcp          # or: pip install grounder-mcp

Configure

Claude Desktop, Cursor, LM Studio, Continue.dev, or any MCP client. The key is optional - omit it to try Grounder on the shared demo key, or add your own free key from grounder.dev:

{
  "mcpServers": {
    "grounder": {
      "command": "uvx",
      "args": ["grounder-mcp"],
      "env": { "GROUNDER_API_KEY": "gnd_live_your_key" }
    }
  }
}

The four tools

ToolWhat it does
web_searchGoogle organic results plus people-also-ask, related searches, and the knowledge graph. The top snippet often already holds the answer.
fetchOne page as clean markdown, capped to your token budget, plus the final URL after redirects.
deep_searchOne search, read across the pages it surfaces, ranked into a token-capped, cited evidence pack. Optional grounded answer.
researchInvestigates an open question with no ready-made answer: it plans, reads primary sources, notices what is missing, goes back for it, and reasons to a grounded conclusion.

Why use it

  • It fits a small context window. Results come back token-capped, so they slot into an 8-32k local model instead of overflowing it. A few raw pages can be 20,000+ tokens (we measured 22,759 for one query) - enough to make a small model return nothing. You get the relevant passages, not whole pages.
  • The live page, not a cached copy. fetch reads the actual current page; any caching is short, timestamped, and force-refreshable.
  • Flat monthly price, billed in pages. You only pay for pages actually delivered. No per-call metering.
  • No query content stored. Ever.

Pricing

Free: 1,500 pages/month, no card. Starter $9/mo, Pro $19/mo. Full table at https://grounder.dev/pricing.

الأسئلة الشائعة

ما هو Grounder؟

Web grounding for local & cloud LLMs: search, fetch, token-capped evidence packs, and research.

كيف أثبّت Grounder؟

يعمل على جهازك. في Claude Code: claude mcp add grounder -e 'GROUNDER_API_KEY=<your grounder_api_key>' -- uvx grounder-mcp==0.4.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Grounder إلى مفتاح API؟

نعم. يتطلب GROUNDER_API_KEY، وتضبطها في إعداداته.

هل Grounder مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Grounder؟

ينشره rozetyp. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.