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.1 está 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

Ú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: DeepSearch 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-mcp

Alternativamente, un host MCP puede ejecutar el paquete sin una instalación global:

npx -y groundlink-mcp

El 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

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 publishing

El 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.