groundlink-mcp
Fetches search results from DuckDuckGo, returning source-bearing entries with titles, URLs, and snippets.
Fetches search results from Wikipedia, returning source-bearing entries with titles, URLs, and snippets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@groundlink-mcp Search for the latest Mars rover discoveries and cite your sources"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Groundlink MCP Server
Use Groundlink's cited web-search results from any Model Context Protocol (MCP)
host. The server exposes one focused tool, groundlink_search, which sends a
query to Groundlink and returns source-bearing results (title, url,
snippet, and source) for the model to use when it needs evidence rather
than a guess.
Groundlink currently combines Wikipedia and DuckDuckGo results. Each Groundlink API key includes 100 free test queries; after that, prepaid usage is $0.001 per query (one credit per query).
Package:
groundlink-mcp@0.1.1is published on npm. Source: https://github.com/ohhavefun/groundlink
Live API documentation: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
Pricing and credits: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing
This repository is the home of Groundlink's official developer integrations. There are two, both maintained here:
Integration | What it is | Install |
groundlink-mcp (MCP server) | Exposes Groundlink to any MCP host (Claude, Cursor, …) |
|
langchain-groundlink (Python/LangChain) | A |
|
Both use the same free trial keys (100 queries) from the Groundlink onboarding, then prepaid usage at $0.001/query.
Where Groundlink is listed
Related MCP server: agent-web-search-mcp
langchain-groundlink (Python / LangChain)
Use Groundlink's cited search from any Python agent or BaseTool pipeline.
The tool returns source-bearing results (title, url, snippet, source)
so your agent answers from evidence and can cite it.
Install from GitHub (the package is intentionally not on PyPI):
pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"Quick usage (10 seconds): get a free key from the docs, then:
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)Full usage, configuration, and error handling are in
langchain-groundlink/README.md.
Groundlink MCP Server
Use Groundlink's cited web-search results from any Model Context Protocol (MCP) host below.
Field | Value |
Tool name |
|
Input |
|
| 1–10; default 5 (or |
Output | JSON: |
Use it for factual questions where the host should return URLs/sources with its answer. The MCP server is deliberately thin: it forwards the query to the Groundlink HTTPS API and returns the API response over MCP stdio.
Install and run
You need a Groundlink API key (glk_...). Ask the Groundlink operator for one
or obtain one through the Groundlink onboarding flow.
npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcpAlternatively, an MCP host can execute the package without a global install:
npx -y groundlink-mcpThe process uses stdio; it does not open an HTTP port or print normal output to stdout. MCP hosts should launch it rather than running it interactively.
Configuration
Variable | Required | Default | Meaning |
| Yes | — | API key used for every Groundlink request. |
| No | Groundlink live URL | Override only for a compatible deployment. |
| No |
| Default results per tool call; capped at |
Claude Desktop configuration
Add this entry to Claude Desktop's MCP configuration file and restart Claude Desktop. Keep the API key private: do not commit it to a repository or share the configuration file.
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": ["-y", "groundlink-mcp"],
"env": {
"GROUNDLINK_API_KEY": "glk_your_key_here"
}
}
}
}If the package is installed globally, use "command": "groundlink-mcp" and
omit args. For hosts that need an absolute executable path, point command
at the installed groundlink-mcp binary.
What happens on errors
Missing
GROUNDLINK_API_KEY: the server exits at startup with a clear setup error.API key rejected (401): returned to the MCP host as a tool error; correct the key rather than retrying.
No remaining free or prepaid credits (402): returned as a tool error; fund the key before another search.
Search-source outage (502): returned as a tool error; a short retry may help.
Marketplace description
Groundlink — cited web search for MCP. Give Claude, Cursor, and other MCP
hosts one groundlink_search tool that returns source-bearing results instead
of unsupported factual guesses. Every key starts with 100 free tests, then
usage is $0.001 per query through prepaid credits.
Development and release checks
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 publishingThe npm package intentionally ships only the compiled dist/ runtime, this
README, and npm's required package metadata. Source and smoke tests stay out of
the 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.
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
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to perform real-time Google searches and retrieve web results via the MCP protocol.-
- 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.-