groundlink-mcp
Groundlink MCP Server
Nutzen Sie Groundlinks zitierte Websuchergebnisse von jedem Model Context Protocol (MCP)-Host aus. Der Server stellt ein einziges fokussiertes Tool bereit, groundlink_search, das eine Abfrage an Groundlink sendet und quellenbehaftete Ergebnisse (title, url, snippet und source) zurückgibt, damit das Modell sie verwenden kann, wenn es Belege statt einer Vermutung benötigt.
Groundlink kombiniert derzeit Wikipedia- und DuckDuckGo-Ergebnisse. Jeder Groundlink-API-Schlüssel enthält 100 kostenlose Testabfragen; danach kostet die Prepaid-Nutzung $0,001 pro Abfrage (ein Guthaben pro Abfrage).
Paket:
groundlink-mcp@0.1.1ist auf npm veröffentlicht. Quellcode: https://github.com/ohhavefun/groundlink
Live-API-Dokumentation: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
Preise und Guthaben: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing
Tool
Feld | Wert |
Tool-Name |
|
Eingabe |
|
| 1–10; Standard 5 (oder |
Ausgabe | JSON: |
Verwenden Sie es für Faktenfragen, bei denen der Host URLs/Quellen mit seiner Antwort zurückgeben soll. Der MCP-Server ist bewusst schlank: Er leitet die Abfrage an die Groundlink-HTTPS-API weiter und gibt die API-Antwort über MCP stdio zurück.
Related MCP server: google-search-mcp
Installation und Ausführung
Sie benötigen einen Groundlink-API-Schlüssel (glk_...). Fragen Sie den Groundlink-Betreiber nach einem oder erhalten Sie einen über den Groundlink-Onboarding-Ablauf.
npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcpAlternativ kann ein MCP-Host das Paket ohne globale Installation ausführen:
npx -y groundlink-mcpDer Prozess verwendet stdio; er öffnet keinen HTTP-Port und gibt keine normale Ausgabe auf stdout aus. MCP-Hosts sollten ihn starten, anstatt ihn interaktiv auszuführen.
Konfiguration
Variable | Erforderlich | Standard | Bedeutung |
| Ja | — | API-Schlüssel, der für jede Groundlink-Anfrage verwendet wird. |
| Nein | Groundlink-Live-URL | Nur für eine kompatible Bereitstellung überschreiben. |
| Nein |
| Standardergebnisse pro Tool-Aufruf; begrenzt auf |
Claude-Desktop-Konfiguration
Fügen Sie diesen Eintrag zur MCP-Konfigurationsdatei von Claude Desktop hinzu und starten Sie Claude Desktop neu. Halten Sie den API-Schlüssel geheim: Committen Sie ihn nicht in ein Repository und teilen Sie die Konfigurationsdatei nicht.
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": ["-y", "groundlink-mcp"],
"env": {
"GROUNDLINK_API_KEY": "glk_your_key_here"
}
}
}
}Wenn das Paket global installiert ist, verwenden Sie "command": "groundlink-mcp" und lassen Sie args weg. Für Hosts, die einen absoluten ausführbaren Pfad benötigen, verweisen Sie mit command auf die installierte groundlink-mcp-Binärdatei.
Was bei Fehlern passiert
Fehlender
GROUNDLINK_API_KEY: Der Server beendet sich beim Start mit einem klaren Einrichtungsfehler.API-Schlüssel abgelehnt (401): Wird als Tool-Fehler an den MCP-Host zurückgegeben; korrigieren Sie den Schlüssel, statt es erneut zu versuchen.
Keine verbleibenden kostenlosen oder Prepaid-Guthaben (402): Wird als Tool-Fehler zurückgegeben; laden Sie den Schlüssel auf, bevor Sie eine weitere Suche durchführen.
Suchquellen-Ausfall (502): Wird als Tool-Fehler zurückgegeben; ein kurzer erneuter Versuch kann helfen.
Marktplatzbeschreibung
Groundlink — zitierte Websuche für MCP. Geben Sie Claude, Cursor und anderen MCP-Hosts ein groundlink_search-Tool, das quellenbehaftete Ergebnisse statt ungestützter Faktenvermutungen zurückgibt. Jeder Schlüssel beginnt mit 100 kostenlosen Tests, danach kostet die Nutzung $0,001 pro Abfrage über Prepaid-Guthaben.
Entwicklungs- und Release-Prüfungen
bun install
bun run typecheck
bun run build # emits executable dist/index.js
bun run test # MCP stdio smoke test
npm run pack:check # inspect the npm tarball without publishingDas npm-Paket enthält absichtlich nur die kompilierte dist/-Laufzeit, diese README und die von npm benötigten Paketmetadaten. Quellcode und Smoke-Tests bleiben außerhalb des Tarballs.
Available Tools
1 toolgroundlink_searchA
Search Groundlink's verified index (Wikipedia + DuckDuckGo) for a query and return cited results (title, url, snippet, source) so the model can answer with sources. Each call costs a fraction of a cent against the API key's free/credit balance. Prefer this over guessing when a factual claim needs verification or a source.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query to ground. Use a concise, factual question or phrase. | |
| max_results | No | How many cited results to return (1–10). Defaults to 5. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, the description carries the full burden. It discloses meaningful behavioral traits: searches a verified index rather than arbitrary web content, returns structured cited results, and mentions cost ('a fraction of a cent against the API key's free/credit balance'). It does not mention rate limits or explicit read-only semantics, but the search action clearly implies no mutation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact at three sentences, front-loads the primary purpose and output, adds a relevant cost note, and closes with usage guidance. Every sentence adds distinct value with no redundancy or filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is reasonably complete for a search tool with no output schema: it lists the returned fields, explains the verified-index scope, and provides cost awareness. It does not cover failure modes or authorization requirements, but for a read-only search operation these are not critical gaps and the essential calling context is present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description does not add parameter-specific semantics beyond what the schema already provides; the 'query' guidance and max_results behavior are already fully documented in the input schema. No additional insight is given about parameter formats or edge cases.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb ('Search'), names the exact resource ('Groundlink's verified index (Wikipedia + DuckDuckGo)'), and enumerates the returned fields ('title, url, snippet, source'). This unambiguously explains what the tool does and what output it produces, easily distinguishing it from any guessing or other knowledge retrieval behavior.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives explicit when-to-use guidance: 'Prefer this over guessing when a factual claim needs verification or a source.' It also implicitly states when not to use it (do not guess) and is the only tool of its kind, so no alternative routing is needed. This is direct and actionable.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v0.1.1- First observed
groundlink_search
TDQS
Scored across 1 tool
With only one tool, there is no possibility of overlap or confusion between tools. The single search tool has a clearly defined purpose.
The tool name follows a clear and logical pattern: groundlink_search. Although there is only one tool, the naming is consistent with common conventions and leaves no ambiguity.
A single tool feels thin for a server, but it is focused on one specific search function that could be reasonably self-contained. It does not appear excessive, yet the surface is minimal.
For a search-focused server, the tool fully covers the core capability of searching and returning cited results. There are no obvious missing operations for its apparent purpose.
Maintenance
Related MCP Connectors
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Web search, scraping, RAG answers with citations, and translation as MCP tools.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
MCP-native web evidence and claim verification: cited, source-grounded evidence for AI agents.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables web search and site-specific search capabilities through the Deepsearch model. Provides unified access to broad web retrieval and targeted site search functionality within the MCP ecosystem.27 npm5Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to perform real-time Google searches and retrieve web results via the MCP protocol.-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.1 npm2Apache 2.0
- FlicenseAqualityCmaintenanceEnables MCP-compatible agents to perform web searches via the agent-web-search engine, returning ranked results with sources.1-