Provides cited web search results from Wikipedia and DuckDuckGo to AI clients for evidence-based answering.
Also known as ohhavefun/groundlink, groundlink-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Aug 25, 2026
- License
- —
What is Groundlink MCP?
Groundlink provides cited web search results from Wikipedia and DuckDuckGo to AI clients for evidence-based answering.
Summary generated from the project's README
About Groundlink MCP server
Groundlink provides a specialized search tool for AI clients that require factual evidence rather than guesses. By connecting to Wikipedia and DuckDuckGo, the server delivers search results that include titles, URLs, snippets, and specific sources. This allows models to provide answers backed by verifiable citations.
Developers can integrate this functionality into MCP hosts like Claude or Cursor using the groundlink_search tool. The server operates via stdio and requires a Groundlink API key for all requests. Users can install the package globally via npm or run it directly using npx.
Each API key begins with 100 free test queries. Once these credits are exhausted, the service operates on a prepaid model costing $0.001 per query. The server includes configuration options to adjust the maximum number of results returned per search, with a limit of 10 results.
What you can do with it
- 1Verify factual claimsAsk the AI to find specific evidence from Wikipedia or DuckDuckGo to support a historical or scientific statement.
- 2Reduce model hallucinationsProvide the AI with real-world snippets and URLs so it avoids making unsupported guesses.
- 3Build Python-based agentsIntegrate cited search capabilities into a LangChain pipeline using the dedicated Python tool.
Written from the project's README. Every use case is checked against a quote from it.
How to install Groundlink MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Groundlink MCP in Claude Code
$ claude mcp add --env 'GROUNDLINK_API_KEY=<YOUR_GROUNDLINK_API_KEY>' groundlink -- npx -y groundlink-mcpInstall Groundlink MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": [
"-y",
"groundlink-mcp"
],
"env": {
"GROUNDLINK_API_KEY": "<YOUR_GROUNDLINK_API_KEY>"
}
}
}
}Install Groundlink MCP in VS Code
.vscode/mcp.json
{
"servers": {
"groundlink": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"groundlink-mcp"
],
"env": {
"GROUNDLINK_API_KEY": "<YOUR_GROUNDLINK_API_KEY>"
}
}
}
}Install Groundlink MCP in VS Code CLI
$ code --add-mcp '{"name":"groundlink","type":"stdio","command":"npx","args":["-y","groundlink-mcp"],"env":{"GROUNDLINK_API_KEY":"<YOUR_GROUNDLINK_API_KEY>"}}'Install Groundlink MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": [
"-y",
"groundlink-mcp"
],
"env": {
"GROUNDLINK_API_KEY": "<YOUR_GROUNDLINK_API_KEY>"
}
}
}
}Install Groundlink MCP in Codex
$ codex mcp add groundlink --env 'GROUNDLINK_API_KEY=<YOUR_GROUNDLINK_API_KEY>' -- npx -y groundlink-mcpInstall Groundlink MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.groundlink] command = "npx" args = ["-y", "groundlink-mcp"] [mcp_servers.groundlink.env] GROUNDLINK_API_KEY = "<YOUR_GROUNDLINK_API_KEY>"
Install Groundlink MCP in Gemini CLI
$ gemini mcp add -s user -e 'GROUNDLINK_API_KEY=<YOUR_GROUNDLINK_API_KEY>' groundlink npx -- -y groundlink-mcpInstall Groundlink MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"groundlink": {
"command": "npx",
"args": [
"-y",
"groundlink-mcp"
],
"env": {
"GROUNDLINK_API_KEY": "<YOUR_GROUNDLINK_API_KEY>"
}
}
}
}Configuration
GROUNDLINK_API_KEYRequiredSecretGroundlink API key used for every cited web-search request.
| Name | Description | |
|---|---|---|
| GROUNDLINK_API_KEY | Groundlink API key used for every cited web-search request. | RequiredSecret |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableohhavefun/groundlink is public and reachablegithub.com/ohhavefun/groundlink ↗Pass
- Package names this repository as its sourcegroundlink-mcp names ohhavefun/groundlink as sourcenpmjs.com/package/groundlink-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-08-25github.com/ohhavefun/groundlink ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from groundlink-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGroundlink 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, …) | npm install -g groundlink-mcp (also on the official MCP registry as io.github.ohhavefun/groundlink) |
| langchain-groundlink (Python/LangChain) | A GroundlinkSearchTool for Python agents |
pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink" |
Both use the same free trial keys (100 queries) from the Groundlink onboarding, then prepaid usage at $0.001/query.
Where Groundlink is listed
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 | groundlink_search |
| Input | { query: string, max_results?: number } |
max_results |
1–10; default 5 (or GROUNDLINK_MAX_RESULTS) |
| Output | JSON: { query, results: [{ title, url, snippet, source }], meta } |
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-mcp
Alternatively, an MCP host can execute the package without a global install:
npx -y groundlink-mcp
The 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 |
|---|---|---|---|
GROUNDLINK_API_KEY |
Yes | — | API key used for every Groundlink request. |
GROUNDLINK_BASE_URL |
No | Groundlink live URL | Override only for a compatible deployment. |
GROUNDLINK_MAX_RESULTS |
No | 5 |
Default results per tool call; capped at 10. |
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 publishing
The 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.
Groundlink MCP questions
How do I add Groundlink MCP to Claude Code?
Run claude mcp add --env 'GROUNDLINK_API_KEY=<YOUR_GROUNDLINK_API_KEY>' groundlink -- npx -y groundlink-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Groundlink MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does Groundlink cost?
Each API key includes 100 free test queries, after which prepaid usage is $0.001 per query.
What sources does Groundlink search?
Groundlink currently combines results from Wikipedia and DuckDuckGo.
What happens if I run out of credits?
If there are no remaining free or prepaid credits, the server returns a 402 tool error.