Linkbruno

A broken link checker MCP server for Claude Code, Cursor and VS Code

Updated 5 November 20265 min read

Check your site

Up to 25 pages and every link on them. No signup.

On this page
  1. What the agent can do
  2. Connect it
  3. Ask for something specific
  4. Without MCP: the agent link
  5. How it compares to local MCP link checkers

Linkbruno runs a broken link checker MCP server at https://linkbruno.com/mcp. Connect it to Claude Code, Cursor or VS Code and the agent can read the broken links on your site, find each one in your repository by the href it was written with, fix it, and check it again once the fix is live. If your AI tool doesn't speak MCP, a private agent link gives it the same list as plain text.

The server reads results Linkbruno already has from its scheduled crawls. It doesn't crawl on demand, so answers come back in a second, and the list includes everything the crawler knows: which pages carry each link, where on the page it sits, and the archived copy for links to other sites that died.

What the agent can do

There are four tools:

Tool What it returns
list_sites The sites on your account, how many problems each has open, and when each was last checked
get_fix_list Every open problem on one site, in the order to fix them, as Markdown
get_problem One problem in full: the evidence, the fix, and up to 25 pages that carry the link, with the link text, the href and the sentence around it
recheck_problem Re-reads the pages that carry the link and checks it now. Says whether it's fixed, gone from the pages, or still broken

Three of them only read. recheck_problem does what the "Check again" button does in the dashboard, and nothing else. The agent can't change settings, mark problems as intentional or touch billing.

The fix list comes in three parts. "Fix these first" is what's broken on your own site, missing images, email addresses that bounce and links to domains that changed hands. "Dead links to other sites" is next, and "Worth a look" covers redirect chains, http:// links and slow pages. Repeats are folded together, so 130 links to one share-button host arrive as one entry with one fix.

Each problem carries the href exactly as it's written in your HTML. That's what makes the agent useful here: it can search the repository for that string instead of guessing which template produced the page.

Connect it

The quickest way is from your site in Linkbruno: open the Use with AI tab, choose In your code, pick your tool and press Make a token and fill it in. The setup on screen then has the token in it, ready to copy. The token is shown once. It can read your fix lists and re-check a problem, and it can't run CI checks or open the dashboard. A token made for CI can't use the MCP server either.

You can also make the token under Account, API tokens, choosing AI agents over MCP. Then add the server to your tool as below, with your token in place of YOUR_TOKEN.

Claude Code

Run this in your project:

claude mcp add --transport http linkbruno https://linkbruno.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in the project:

{
  "mcpServers": {
    "linkbruno": {
      "url": "https://linkbruno.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "linkbruno": {
      "type": "http",
      "url": "https://linkbruno.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

If the token ends up in a file inside your repository, keep that file out of version control, or use your tool's way of reading the header from an environment variable.

Ask for something specific

The server also offers four prompts. Some clients, Claude Code among them, list them as slash commands. You can write the same thing yourself:

  • "Fix the broken links on example.com in this repo. Use the archived copy for dead links to other sites, and don't make up addresses."
  • "Make me an edit list for my CMS: one row per page, the link text to look for, and what to change it to."
  • "Look only at pages on example.com that are gone and suggest a redirect for each. Ask me which host I use first."
  • "Explain which of these problems hurt readers or search rankings, and give me the five fixes that matter most this week."

The instruction not to invent addresses matters. A model asked to fix a dead link will happily guess a plausible URL. The fix list gives it something better: the final address of a redirect, the Wayback Machine copy of a dead page, or the advice to remove the link and keep the sentence readable.

When the fixes are deployed, ask the agent to check them again. recheck_problem reads the pages that carry the link, so a link you removed counts as fixed as well.

ChatGPT and Claude in the browser can't send an API token to a server, so each site also has an agent link. Turn it on from the site's Use with AI tab, under In a chat. It's a private address like https://linkbruno.com/r/ followed by 16 random characters, and it serves the same fix list as plain text. Pick a prompt on that tab and press Open in Claude or Open in ChatGPT: the chat opens with the prompt and the link in it, and the model reads the list itself. If the chat says it can't open links, turn on its web access and ask again.

Anyone who has the link can read the list, the way a shared document works. It shows only what the crawler read on your public pages. Turning it off, or making a new one, ends the old link at once. Search engines are asked not to index it.

There are open-source MCP servers that check links from your own machine. They're a good fit for checking one page or a local build. They start from nothing each time, though: they don't know what was broken yesterday, they meet the same bot walls on every run, and they can't tell a link that broke today from one that has been dead for a year.

Linkbruno keeps that history. A link that only ever answers a bot with LinkedIn's 999 or a Cloudflare challenge shows as "blocked, couldn't check" rather than as broken, so the agent doesn't remove links that work for your readers. If you want the same check before a merge as well, the CI check runs against your preview deploy.

See what’s broken on your site

The free scan reads up to 25 pages and checks every link on them. No signup.

Related