LinkList — Connect · Claude Code

Connect LinkList to Claude Code.

One command registers the endpoint. Claude Code then calls search_sources when a question touches a collection you curated, and answers with the source attached.

Verified against the live endpoint on 2026-07-27.

01 — Get a key

One key per agent or machine. It reads every collection in your account, and can add sources unless you turn that off.

Free · 100 queries/day · no card

No account yet? The demo collection publishes a live read-only key you can paste in place of your own. Query the demo collection first

02 — Add the endpoint

Run this anywhere. The key goes in the header, not the URL, so it never lands in shell history that gets shared.

$ claude mcp add --transport http linklist https://linklist.io/mcp \
--header "Authorization: Bearer llk_YOUR_KEY"

03 — Check it connected

The health check runs on every start. A connected server prints its URL and transport.

$ claude mcp list

EXPECTED OUTPUT

linklist: https://linklist.io/mcp (HTTP) - ✔ Connected

Also works

Committing the endpoint to a repository shares it with everyone who clones it. Claude Code asks each of them to approve the server on first run, so the key is the only thing you still have to hand over separately.

FILE .mcp.json

{
"mcpServers": {
"linklist": {
"type": "http",
"url": "https://linklist.io/mcp",
"headers": {
"Authorization": "Bearer llk_YOUR_KEY"
}
}
}
}

04 — Ask your agent

Ask something your sources cover. Every passage comes back with its URL and the date it was fetched, so the answer is checkable.

> which payroll APIs handle contractor payments?
  search_sources → 8 citations
  [1] highline.co · fetched 2026-07-27 · link_id 7
  [2] atomic.financial · fetched 2026-07-27 · link_id 1
  [3] truv.com · fetched 2026-07-27 · link_id 3

What your agent can call

Five tools, three of them read-only.

Every key lists all five. A read-only key still sees the two write tools and refuses the call, so an agent that tries to add a source gets an error rather than silently writing.

  • search_sources Search vetted sources
  • list_collections List available collections
  • get_source Get full source text
  • add_source Add a source to a collection
  • create_collection Create a collection

Protocol 2025-11-25, negotiated down to 2025-06-18 and 2025-03-26 for older clients.

When it does not work

Failed to connect — HTTP 401
The key is revoked, mistyped, or missing its Bearer prefix. The endpoint answers with -32001 "Invalid or missing API key". Create a new key and re-run the add command; there is nothing to fix on the client.
Pending approval — run claude to approve
Servers in a project .mcp.json need approving once per person. Start claude in that directory and accept. Adding with --scope local instead keeps the server on your machine and skips the prompt.
The tools do not show up
Check the server is connected before looking at tools: claude mcp list prints the state of each one. Tools are registered at connection time, so a server that failed auth registers none.

Other clients

The endpoint is the same for every client that speaks MCP over streamable HTTP. Only the file it goes in changes.

MCP starter pack

Verified setup configs for every client.

Copy-paste configuration for Claude Code, Claude Desktop and Cursor, plus the eval harness so you can measure your own retrieval.

One email with the pack. No sequence.

Point your agent at sources you trust.

Free tier, no card. The endpoint is live now.