groundlink-mcp
Servidor MCP de Groundlink
Usa los resultados de búsqueda web citados de Groundlink desde cualquier host de Model Context Protocol (MCP). El servidor expone una herramienta enfocada, groundlink_search, que envía una consulta a Groundlink y devuelve resultados con fuentes (title, url, snippet y source) para que el modelo los use cuando necesite evidencia en lugar de una suposición.
Groundlink combina actualmente resultados de Wikipedia y DuckDuckGo. Cada clave de API de Groundlink incluye 100 consultas de prueba gratuitas; después, el uso prepagado es de $0,001 por consulta (un crédito por consulta).
Paquete:
groundlink-mcp@0.1.1está publicado en npm. Código fuente: https://github.com/ohhavefun/groundlink
Documentación de la API en vivo: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
Precios y créditos: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing
Herramienta
Campo | Valor |
Nombre de la herramienta |
|
Entrada |
|
| 1–10; predeterminado 5 (o |
Salida | JSON: |
Úsala para preguntas factuales en las que el host deba devolver URLs/fuentes con su respuesta. El servidor MCP es deliberadamente ligero: reenvía la consulta a la API HTTPS de Groundlink y devuelve la respuesta de la API a través de MCP stdio.
Related MCP server: websearch-mcp
Instalación y ejecución
Necesitas una clave de API de Groundlink (glk_...). Pide una al operador de Groundlink u obtén una a través del flujo de incorporación de Groundlink.
npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcpAlternativamente, un host MCP puede ejecutar el paquete sin una instalación global:
npx -y groundlink-mcpEl proceso usa stdio; no abre un puerto HTTP ni imprime salida normal en stdout. Los hosts MCP deben lanzarlo en lugar de ejecutarlo de forma interactiva.
Configuración
Variable | Requerida | Predeterminado | Significado |
| Sí | — | Clave de API usada para cada solicitud de Groundlink. |
| No | URL en vivo de Groundlink | Anula solo para un despliegue compatible. |
| No |
| Resultados predeterminados por llamada de herramienta; limitado a |
Configuración de Claude Desktop
Añade esta entrada al archivo de configuración MCP de Claude Desktop y reinicia Claude Desktop. Mantén la clave de API privada: no la confirmes en un repositorio ni compartas el archivo de configuración.
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": ["-y", "groundlink-mcp"],
"env": {
"GROUNDLINK_API_KEY": "glk_your_key_here"
}
}
}
}Si el paquete está instalado globalmente, usa "command": "groundlink-mcp" y omite args. Para hosts que necesiten una ruta ejecutable absoluta, apunta command al binario groundlink-mcp instalado.
Qué ocurre con los errores
Falta
GROUNDLINK_API_KEY: el servidor se cierra al inicio con un error de configuración claro.Clave de API rechazada (401): se devuelve al host MCP como un error de herramienta; corrige la clave en lugar de reintentar.
Sin créditos gratuitos o prepagados restantes (402): se devuelve como un error de herramienta; recarga la clave antes de otra búsqueda.
Caída de la fuente de búsqueda (502): se devuelve como un error de herramienta; un reintento breve puede ayudar.
Descripción para el marketplace
Groundlink: búsqueda web citada para MCP. Dale a Claude, Cursor y otros hosts MCP una herramienta groundlink_search que devuelve resultados con fuentes en lugar de suposiciones factuales sin respaldo. Cada clave comienza con 100 pruebas gratuitas; después, el uso es de $0,001 por consulta mediante créditos prepagados.
Comprobaciones de desarrollo y publicación
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 publishingEl paquete npm incluye intencionadamente solo el runtime compilado dist/, este README y los metadatos de paquete requeridos por npm. El código fuente y las pruebas de humo quedan fuera del tarball.
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.
Inputs: query (required), max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Google search, news, maps, webpages, cited answers, research and ChatGPT/Gemini answers for agents.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables MCP-compatible agents to perform web searches via the agent-web-search engine, returning ranked results with sources.1-
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI applications to perform web searches via OpenAI's web search tool and receive concise factual results with source URLs, while leaving comparison and final reasoning to the calling AI.MIT
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to run real-time searches across Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and other engines, with automatic formatting of answer boxes, organic results, news, images, shopping, weather, and stock data. Responses can be returned as structured JSON or token-efficient Markdown.-
- AlicenseCqualityBmaintenanceEnables existing AI assistants to search locally collected web evidence, retrieve cited results, exact quotes, revision IDs, and capture timestamps, and verify source listings through MCP.361MIT