linkup-mcp
An MCP server for the whole Linkup web API, one tool per operation, with Linkup's own operational guidance (prices, latencies, limits, polling rules, best practices) in the tool descriptions and in a built-in guide. Stdio transport, Python, two dependencies.
Not affiliated with Linkup. Written against https://api.linkup.so/v1/openapi.json and the
documentation as read on 2026-11-13; the snapshot of the spec is shipped as a resource.
Why
Linkup's official server (linkup-mcp-server,
also hosted at https://mcp.linkup.so/mcp) exposes four tools: linkup-search (always a
sourced answer, no output type), linkup-research (output fixed to sourcedAnswer),
linkup-get-research and linkup-fetch (no pro mode, no schema extraction). It has no
research listing, no batch tasks, no credit balance, no extract, rewind or responses. This
server keeps those four tool names, gives them every documented parameter, and adds the rest.
Tools
| Tool | API | Billed per call (USD) |
|---|---|---|
| linkup-search | POST /search | 0.005 to 0.055 |
| linkup-fetch | POST /fetch | 0.001 to 0.011 |
| linkup-research | POST /research (create task) | 0.25 (S), 0.50 (M), 1.50 (L), 2.50 (XL) |
| linkup-wait-research | GET /research/{id}, polled 2 s doubling to 10 s, time-boxed, resumable | free |
| linkup-get-research | GET /research/{id} | free |
| linkup-list-research | GET /research | free |
| linkup-tasks-create | POST /tasks, 1 to 100 items, dry_run returns the cost estimate |
as the wrapped calls |
| linkup-tasks-get | GET /tasks/{id} | free |
| linkup-tasks-list | GET /tasks, with type and status filters and the concurrency quota | free |
| linkup-credits-balance | GET /credits/balance | free |
| linkup-extract, linkup-get-extract, linkup-list-extract, linkup-extract-download | /extract (closed beta: 403 unless enabled) | variable, 2 to 10 typical |
| linkup-rewind-search, linkup-rewind-fetch | /rewind (closed beta) | not published |
| linkup-responses | POST /responses (OpenAI Responses format) | not published |
| linkup-guide | documentation, no network | free |
Resources: linkup://guide (the full guide) and linkup://openapi.json (the spec snapshot).
Behaviour worth knowing:
- Research tasks are created once and polled.
linkup-wait-researchreturns aftermax_wait_seconds(default 600) withdone: falseif the task still runs and can be called again with the same id. It never re-creates a task. - Every response is capped by
max_chars. Truncation order: raw content and source snippets first, then trailing sources, the answer or markdown last._truncatedand_hintsay when it happened. Research answers come back byte-identical to the API unless they alone exceed the cap. linkup-list-researchandlinkup-tasks-listreturn anoutput_previewper task;include_output: truereturns the full outputs.- Errors carry Linkup's status code, its error body, and a one-line hint (for example 429: rate limit or empty balance).
Install
With uv, from PyPI, no checkout needed:
uvx linkup-mcp
Claude Code, user scope (the key goes into the env of the entry, never on the command line):
claude mcp add-json --scope user linkup '{"type":"stdio","command":"uvx","args":["linkup-mcp"],"env":{"LINKUP_API_KEY":"<key>"}}'
The current main branch instead of the release: replace linkup-mcp in args with
--from, git+https://github.com/cybernagl/linkup-mcp, linkup-mcp, or run
uvx --from git+https://github.com/cybernagl/linkup-mcp linkup-mcp
Any other MCP client: run linkup-mcp (or python -m linkup_mcp) over stdio with
LINKUP_API_KEY in the environment.
Environment: LINKUP_API_KEY (required), LINKUP_BASE_URL (default
https://api.linkup.so/v1), LINKUP_TIMEOUT (seconds per HTTP request, default 180).
From a checkout:
git clone https://github.com/cybernagl/linkup-mcp && cd linkup-mcp
uv venv && uv pip install -e .
.venv/bin/linkup-mcp
Test
.venv/bin/python tests/test_wait.py # offline: wait loop, error mapping, truncation, list summaries
.venv/bin/python tests/selftest.py # protocol checks, plus free live calls when LINKUP_API_KEY is set
.venv/bin/python tests/selftest.py --paid # adds two fast searches and two fetches, about 0.014 USD
The self-test never creates a research task (0.25 USD and up). GitHub Actions runs the offline tests and the protocol self-test on Python 3.11, 3.12 and 3.13 for every push.
Claude Code Notes
- Results above 50,000 characters (or
MAX_MCP_OUTPUT_TOKENS, default 25,000 tokens) are saved to a file by Claude Code and handed over as a path. The defaultmax_charscaps (40,000 for search, fetch and lists; 48,000 for a research or task result) keep results inline; raisemax_charswhen you want everything. MCP_TOOL_TIMEOUTdefaults to about 28 hours and stdio servers have no per-request timer, so long research waits are safe.
Updating the Guide
Prices, limits and wording come from Linkup's documentation
(https://docs.linkup.so/llms.txt). They live in src/linkup_mcp/server.py next to
DOCS_READ_DATE. When Linkup changes something, update the text and the date, and replace
src/linkup_mcp/openapi.json with a fresh download of the spec.
License
MIT.
Metadata
Release files for linkup-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| linkup_mcp-0.1.0.tar.gz | 34.6 kB | Without provenance | Details for linkup_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| linkup_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for linkup_mcp-0.1.0-py3-none-any.whl |
Total release size: 66.7 kB
Release files / linkup_mcp-0.1.0.tar.gz
| Download URL | linkup_mcp-0.1.0.tar.gz |
|---|---|
| Size | 34.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
85c85b70e2805b2cabaa1e53eb35770a5f91a3e0dcfeae42e1bfdf34269c8f3b
|
|
BLAKE2b-256 checksum How to use checksums |
6f06222a5d706ca0b98d9bd9bd965b997b20627f7eebdf0b75ee391a01b874ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / linkup_mcp-0.1.0-py3-none-any.whl
| Download URL | linkup_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 32.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4ac8c7a7c1062c30f439b7b1fcc8ef63fe6e5e898bc5c174ba31ec19937c4337
|
|
BLAKE2b-256 checksum How to use checksums |
472f80ddd95e42dc2fbdc05b4a374656310beb150c867ecf1c095bbc5a34ff4d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for linkup-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.