Skip to main content

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

Tool What it does
web_search Google organic results plus people-also-ask, related searches, and the knowledge graph. The top snippet often already holds the answer.
fetch One page as clean markdown, capped to your token budget, plus the final URL after redirects.
deep_search One search, read across the pages it surfaces, ranked into a token-capped, cited evidence pack. Optional grounded answer.
research Investigates 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.

Metadata

Release files for grounder-mcp 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for grounder-mcp 0.4.1
File Size Uploaded
grounder_mcp-0.4.1.tar.gz 12.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for grounder-mcp 0.4.1
File Interpreter ABI Platform
grounder_mcp-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 25.6 kB

Release files / grounder_mcp-0.4.1.tar.gz

Download URL grounder_mcp-0.4.1.tar.gz
Size 12.7 kB
Tags Source
SHA-256 checksum
How to use checksums
49c28fbb544a4c6b26e1aa3ff46532a2a133b084909a97abd43814f41089a36e
BLAKE2b-256 checksum
How to use checksums
c1e277f998b8f0bd0d10a9e0f8970317c59b3f720ee4d4bffa9ac55ea16c242d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / grounder_mcp-0.4.1-py3-none-any.whl

Download URL grounder_mcp-0.4.1-py3-none-any.whl
Size 12.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6b7a8469c342d50cd5cf86d51bbfc0688d2a4695dbc8d8783811c255d6fa8ef7
BLAKE2b-256 checksum
How to use checksums
725b12ba10a820efe1cbe493c2a30cfa5b9709706b2a2f6d6ef917dc091a0c62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page