Skip to main content

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-research returns after max_wait_seconds (default 600) with done: false if 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. _truncated and _hint say when it happened. Research answers come back byte-identical to the API unless they alone exceed the cap.
  • linkup-list-research and linkup-tasks-list return an output_preview per task; include_output: true returns 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 default max_chars caps (40,000 for search, fetch and lists; 48,000 for a research or task result) keep results inline; raise max_chars when you want everything.
  • MCP_TOOL_TIMEOUT defaults 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)

Source distribution for linkup-mcp 0.1.0
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)

Table of built distributions (wheels) for linkup-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page