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.
O que dá para fazer com 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.
Instalação
Adicione Grounder ao seu cliente. Escolha o que você usa.
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.
Pontuação
39 / 100
Incompleta
- Documentação22/25
- Manutenção25/25
- Confiança13/20
- Capacidade0/15
- Instalação12/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
Histórico de versões
| Versões | Publicada |
|---|---|
| 0.4.1Mais recente | 13 de ago. de 2026 |
| 0.4.0 | 13 de ago. de 2026 |
| 0.3.1 | 23 de jul. de 2026 |