Groundlink

Servidor MCP Groundlink

Use os resultados de pesquisa web citados do Groundlink em qualquer host do Model Context Protocol (MCP). O servidor expõe uma ferramenta focada, groundlink_search, que envia uma consulta ao Groundlink e retorna resultados com fontes (title, url, snippet e source) para o modelo usar quando precisar de evidências em vez de suposições.

O Groundlink atualmente combina resultados da Wikipedia e do DuckDuckGo. Cada chave de API do Groundlink inclui 100 consultas de teste gratuitas; depois disso, o uso pré-pago é US$ 0,001 por consulta (um crédito por consulta).

Pacote: groundlink-mcp@0.1.1 é publicado no npm. Código-fonte: https://github.com/ohhavefun/groundlink

• Documentação da API ao vivo: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
• Preços e créditos: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing

Este repositório é a casa das integrações oficiais para desenvolvedores do Groundlink. Existem duas, ambas mantidas aqui:

Integração	O que é	Instalação
groundlink-mcp (servidor MCP)	Expõe o Groundlink a qualquer host MCP (Claude, Cursor, …)	npm install -g groundlink-mcp (também no registro oficial de MCP como io.github.ohhavefun/groundlink)
langchain-groundlink (Python/LangChain)	Um GroundlinkSearchTool para agentes Python	pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

Ambas usam as mesmas chaves de teste gratuito (100 consultas) do onboarding do Groundlink, e depois uso pré-pago a US$ 0,001/consulta.

---

langchain-groundlink (Python / LangChain)

Use a pesquisa citada do Groundlink em qualquer agente Python ou pipeline BaseTool. A ferramenta retorna resultados com fontes (title, url, snippet, source) para que seu agente responda com base em evidências e possa citá-las.

Instalação pelo GitHub (o pacote está intencionalmente fora do PyPI):

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

Uso rápido (10 segundos): obtenha uma chave gratuita em a documentação e depois:

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)

Uso completo, configuração e tratamento de erros estão em langchain-groundlink/README.md.

---

Servidor MCP Groundlink

Use os resultados de pesquisa web citados do Groundlink em qualquer host do Model Context Protocol (MCP) abaixo.

Campo	Valor
Nome da ferramenta	groundlink_search
Entrada	{ query: string, max_results?: number }
max_results	1–10; padrão 5 (ou GROUNDLINK_MAX_RESULTS)
Saída	JSON: { query, results: [{ title, url, snippet, source }], meta }

Use-o para perguntas factuais em que o host deve retornar URLs/fontes junto com sua resposta. O servidor MCP é deliberadamente enxuto: ele encaminha a consulta para a API HTTPS do Groundlink e retorna a resposta da API via stdio do MCP.

Instalação e execução

Você precisa de uma chave de API do Groundlink (glk_...). Peça uma ao operador do Groundlink ou obtenha uma pelo fluxo de onboarding do Groundlink.

npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcp

Alternativamente, um host MCP pode executar o pacote sem instalação global:

npx -y groundlink-mcp

O processo usa stdio; ele não abre uma porta HTTP nem imprime saída normal no stdout. Hosts MCP devem iniciá-lo em vez de executá-lo interativamente.

Configuração

Variável	Obrigatória	Padrão	Significado
GROUNDLINK_API_KEY	Sim	—	Chave de API usada em todas as requisições ao Groundlink.
GROUNDLINK_BASE_URL	Não	URL ao vivo do Groundlink	Substitua apenas para uma implantação compatível.
GROUNDLINK_MAX_RESULTS	Não	5	Resultados padrão por chamada de ferramenta; limitado a 10.

Configuração do Claude Desktop

Adicione esta entrada ao arquivo de configuração MCP do Claude Desktop e reinicie o Claude Desktop. Mantenha a chave de API privada: não a envie para um repositório nem compartilhe o arquivo de configuração.

{
  "mcpServers": {
    "groundlink": {
      "command": "npx",
      "args": ["-y", "groundlink-mcp"],
      "env": {
        "GROUNDLINK_API_KEY": "glk_your_key_here"
      }
    }
  }
}

Se o pacote estiver instalado globalmente, use "command": "groundlink-mcp" e omita args. Para hosts que precisam de um caminho absoluto do executável, aponte command para o binário groundlink-mcp instalado.

O que acontece em erros

• GROUNDLINK_API_KEY ausente: o servidor encerra na inicialização com um erro de configuração claro.
• Chave de API rejeitada (401): retornada ao host MCP como erro de ferramenta; corrija a chave em vez de tentar novamente.
• Sem créditos gratuitos ou pré-pagos restantes (402): retornado como erro de ferramenta; adicione créditos à chave antes de outra pesquisa.
• Indisponibilidade da fonte de pesquisa (502): retornado como erro de ferramenta; uma nova tentativa curta pode ajudar.

Descrição para marketplace

Groundlink — pesquisa web citada para MCP. Dê a Claude, Cursor e outros hosts MCP uma ferramenta groundlink_search que retorna resultados com fontes em vez de suposições factuais sem suporte. Cada chave começa com 100 testes gratuitos, e depois o uso custa US$ 0,001 por consulta por meio de créditos pré-pagos.

Verificações de desenvolvimento e lançamento

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

O pacote npm envia intencionalmente apenas o runtime dist/ compilado, este README e os metadados de pacote exigidos pelo npm. O código-fonte e os testes de fumaça ficam fora do tarball.