pypi grounder-mcpstdioMITupdated 26d ago
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.
¿Qué puedes hacer con Grounder?
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.
fetchreads 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.
Instalación
Añade Grounder a tu cliente. Elige el que uses.
claude mcp add grounder-mcp -- uvx grounder-mcpcodex mcp add grounder-mcp -- uvx grounder-mcpamp mcp add grounder-mcp -- uvx grounder-mcp{
"mcpServers": {
"grounder-mcp": {
"command": "uvx",
"args": [
"grounder-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"grounder-mcp": {
"command": "uvx",
"args": [
"grounder-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"grounder-mcp","command":"uvx","args":["grounder-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"grounder-mcp": {
"command": "uvx",
"args": [
"grounder-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"grounder-mcp": {
"command": "uvx",
"args": [
"grounder-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"grounder-mcp": {
"command": "uvx",
"args": [
"grounder-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"grounder-mcp": {
"type": "local",
"command": "uvx",
"args": [
"grounder-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"grounder-mcp": {
"command": {
"path": "uvx",
"args": [
"grounder-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
uvx grounder-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Puntuación
39 / 100
Incompleta
- Documentación22/25
- Mantenimiento25/25
- Confianza13/20
- Capacidad0/15
- Instalación12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 19 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Historial de versiones
| Versiones | Publicada |
|---|---|
| 0.4.1Última | 13 ago 2026 |
| 0.4.0 | 13 ago 2026 |
| 0.3.1 | 23 jul 2026 |