Groundlink

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 actualmente combina resultados de Wikipedia y DuckDuckGo. Cada clave de API de Groundlink incluye 100 consultas de prueba gratuitas; después de eso, el uso prepagado es $0.001 por consulta (un crédito por consulta).

Paquete: groundlink-mcp@0.1.1 está publicado en npm. Fuente: https://github.com/ohhavefun/groundlink

• Documentación de API en vivo: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
• Precios y créditos: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing

Este repositorio es el hogar de las integraciones oficiales para desarrolladores de Groundlink. Hay dos, ambas mantenidas aquí:

Integración	Qué es	Instalación
groundlink-mcp (servidor MCP)	Expone Groundlink a cualquier host MCP (Claude, Cursor, …)	npm install -g groundlink-mcp (también en el registro oficial de MCP como io.github.ohhavefun/groundlink)
langchain-groundlink (Python/LangChain)	Un GroundlinkSearchTool para agentes de Python	pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

Ambas usan las mismas claves de prueba gratuita (100 consultas) del proceso de incorporación de Groundlink, luego uso prepagado a $0.001/consulta.

Dónde está listado Groundlink

---

langchain-groundlink (Python / LangChain)

Usa la búsqueda citada de Groundlink desde cualquier agente de Python o pipeline de BaseTool. La herramienta devuelve resultados con fuentes (title, url, snippet, source) para que tu agente responda con evidencia y pueda citarla.

Instalación desde GitHub (el paquete intencionalmente no está en PyPI):

pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

Uso rápido (10 segundos): obtén una clave gratuita desde la documentación, luego:

from langchain_groundlink import GroundlinkSearchTool

tool = GroundlinkSearchTool(api_key="glk_your_trial_key")  # or export GROUNDLINK_API_KEY
result = tool.invoke({"query": "Who was Ada Lovelace?"})
print(result)

El uso completo, la configuración y el manejo de errores están en langchain-groundlink/README.md.

---

Servidor MCP de Groundlink

Usa los resultados de búsqueda web citados de Groundlink desde cualquier host de Model Context Protocol (MCP) a continuación.

Campo	Valor
Nombre de la herramienta	groundlink_search
Entrada	{ query: string, max_results?: number }
max_results	1–10; predeterminado 5 (o GROUNDLINK_MAX_RESULTS)
Salida	JSON: { query, results: [{ title, url, snippet, source }], meta }

Úsalo para preguntas factuales donde el host deba devolver URLs/fuentes con su respuesta. El servidor MCP es deliberadamente delgado: reenvía la consulta a la API HTTPS de Groundlink y devuelve la respuesta de la API a través de MCP stdio.

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 proceso 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 a stdout. Los hosts MCP deben iniciarlo en lugar de ejecutarlo interactivamente.

Configuración

Variable	Requerida	Predeterminado	Significado
GROUNDLINK_API_KEY	Sí	—	Clave de API usada para cada solicitud de Groundlink.
GROUNDLINK_BASE_URL	No	URL en vivo de Groundlink	Anular solo para una implementación compatible.
GROUNDLINK_MAX_RESULTS	No	5	Resultados predeterminados por llamada de herramienta; limitado a 10.

Configuración de Claude Desktop

Agrega 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 necesitan una ruta de ejecutable absoluta, apunta command al binario groundlink-mcp instalado.

Qué sucede en caso de errores

• Falta GROUNDLINK_API_KEY: el servidor sale 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; financia la clave antes de otra búsqueda.
• Interrupción de la fuente de búsqueda (502): se devuelve como un error de herramienta; un breve reintento puede ayudar.

Descripción del 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, luego el uso es de $0.001 por consulta a través de créditos prepagados.

Verificaciones 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 intencionalmente solo el runtime compilado de dist/, este README y los metadatos de paquete requeridos por npm. El código fuente y las pruebas de humo quedan fuera del tarball.