Skip to main content

MCP connector

Use BacklinkMastery from your AI assistant

Connect Claude, ChatGPT, Le Chat or your code editor to your account, then ask in plain words: which links did I lose, add these links, re-check that page. The assistant reads and updates your BacklinkMastery data for you.

Server address

https://backlink-mastery.com/mcp

Included in every plan, Free plan included.

What you can ask

A few requests and what the assistant does with them. Write in your own words, in your own language.

You ask

Which backlinks have I lost on example.com?

What happens

The assistant searches your backlinks with the “lost” status for that site and lists them with their source page and anchor.

You ask

Give me a quick status of all my sites.

What happens

It reads the overview of your sites: the number of backlinks per status for each one, and the latest losses.

You ask

Here are the 12 links I bought this week, add them to monitoring.

What happens

It adds the 12 backlinks in a single call, with source URL, target URL and anchor when you give one. They are then monitored like the others.

You ask

Re-check the lost links on example.com now, the pages may just have been down.

What happens

It finds those links and starts a new check for up to 20 of them at once. Ask again a little later to read the results.

You ask

Show me the backlinks found automatically for my blog. Accept the ones pointing to my articles, reject the rest.

What happens

It lists the candidates, then accepts or rejects each one according to your instructions.

You ask

How many backlinks can I still add on my plan?

What happens

It reads your plan and your quotas: what you have used and what is left.

Prompt library

Twelve requests to copy into your assistant, grouped by task. Replace the site names with your own.

Monitoring

  • Give me a health check of the backlinks of all my sites.

  • Which backlinks did I lose in the last 7 days, and on which pages?

  • Show me the check history of the link from example.org.

Fixing lost links

  • List the lost links on example.com and re-check them now.

  • Among my lost links, which were removed from the page and which pages are simply unreachable?

  • Write a short, polite message asking the site owner to restore my lost link.

Discovery and new links

  • Show me the backlinks found automatically for my blog.

  • Accept the discovered backlinks with a Trust Flow of 20 or more and reject the others.

  • Here are the links I got this month: add them to monitoring.

Client reports

  • List my client report links.

  • Create a report link I can send to my client.

  • Summarize the state of the backlinks of example.com in a short email for my client.

What your assistant can do

Eleven actions, each limited to your own account. The assistant picks the right one from your request.

  • get_account

    Your plan and how much of each quota you have used.

    Read
  • get_site_overview

    Your sites, with the number of backlinks per status and the latest losses.

    Read
  • list_backlinks

    Search your backlinks by status (for example lost), by site or by text, page by page.

    Read
  • get_backlink_details

    Everything about one backlink: its current state and the history of its checks.

    Read
  • list_discovered_backlinks

    The candidate backlinks found automatically for your sites.

    Read
  • list_shared_reports

    Your client report links: the read-only reports you share with a link.

    Read
  • add_backlinks

    Add up to 50 backlinks in one go: source URL, target URL and, if you want, the expected anchor.

    Write
  • check_backlinks

    Start a new check of up to 20 backlinks (results a few minutes later).

    Write
  • review_discovered_backlinks

    Accept or reject those candidates.

    Write
  • create_shared_report

    Create a new read-only client report link to send to your client.

    Write
  • delete_backlinks

    Delete up to 50 backlinks, flagged as destructive to your assistant.

    Deletion

Connect your assistant

The steps depend on the assistant. The server address is always the same.

Sign in with your account (recommended)

The assistant opens the BacklinkMastery login page, shows what it will be able to do and asks you to approve. Nothing to copy or store.

AI connection token (developer tools)

For a tool that cannot open a login page, create a token in your profile, under AI connections, and send it as a Bearer token. Treat it like a password.

Claude

  1. In Claude (web or desktop app), open Settings, then Connectors.
  2. Add a custom connector and paste the server address.
  3. Click Connect, sign in to BacklinkMastery and approve the access.
Server address
https://backlink-mastery.com/mcp

The Free plan of Claude allows one custom connector; paid plans allow more.

ChatGPT

  1. In ChatGPT on the web, open the Plugins page, click + then Add custom MCP server.
  2. Paste the server address.
  3. Sign in to BacklinkMastery and approve the access.
Server address
https://backlink-mastery.com/mcp

Web version only. Custom connectors are reserved for the Business, Enterprise and Edu plans (on Business, only an admin can add one); ChatGPT Pro can add it in read-only mode. OpenAI does not mention the Free and Plus plans.

Grok

  1. Go to grok.com/connectors, click New Connector, then Custom.
  2. Paste the server address.
  3. Connect, sign in to BacklinkMastery and approve the access.
Server address
https://backlink-mastery.com/mcp

Le Chat (Mistral)

  1. In Le Chat, open Connectors, click + Add Connector and choose the Custom MCP Connector tab.
  2. Give it a name without spaces (for example backlinkmastery) and paste the server address.
  3. Click Connect: the BacklinkMastery page opens; approve the access.
Server address
https://backlink-mastery.com/mcp

Perplexity

  1. In Perplexity, open Settings, then Connectors, and add a custom remote connector.
  2. Paste the server address.
  3. Choose OAuth to sign in with your account, or use an AI connection token as the API key.
Server address
https://backlink-mastery.com/mcp

Claude Code

  1. Run this command in your terminal.
  2. In Claude Code, type /mcp, choose backlinkmastery and sign in.
Command
claude mcp add --transport http backlinkmastery https://backlink-mastery.com/mcp
With a token instead of the login page
claude mcp add --transport http backlinkmastery https://backlink-mastery.com/mcp --header "Authorization: Bearer <token>"

Cursor

  1. Add this block to ~/.cursor/mcp.json (create the file if it does not exist).
  2. Open the MCP section of the Cursor settings and sign in when prompted.
Configuration
{
    "mcpServers": {
        "backlinkmastery": {
            "url": "https://backlink-mastery.com/mcp"
        }
    }
}
With a token instead of the login page
{
    "mcpServers": {
        "backlinkmastery": {
            "url": "https://backlink-mastery.com/mcp",
            "headers": {
                "Authorization": "Bearer <token>"
            }
        }
    }
}

VS Code

  1. Save this file as .vscode/mcp.json at the root of your project.
  2. Click Start above the server entry: the editor opens the sign-in page.
Configuration
{
    "servers": {
        "backlinkmastery": {
            "type": "http",
            "url": "https://backlink-mastery.com/mcp"
        }
    }
}
With a token instead of the login page
{
    "servers": {
        "backlinkmastery": {
            "type": "http",
            "url": "https://backlink-mastery.com/mcp",
            "headers": {
                "Authorization": "Bearer <token>"
            }
        }
    }
}

With a token, do not commit this file to version control: it contains your key.

Security and privacy

  • Secure sign-in (OAuth standard): your password never reaches the assistant, and each connection has its own access.
  • You can revoke a connection or a token at any time in AI connections. The assistant then loses access.
  • The assistant only acts inside your account and within the quotas of your plan, as you would in the dashboard.
  • Deletions are flagged as destructive to your assistant; most assistants then ask for your confirmation, but this depends on the assistant (some offer an “always allow” option).
  • Text taken from third-party pages (anchors, page titles) is returned truncated and marked as external content, to limit the risk of it being taken for an instruction.

Read our privacy policy

Frequently asked questions

Which plans include AI access?
All of them, including the Free plan. The assistant works within the limits of your plan, the same ones as in the dashboard.
Is my data used to train AI models?

We do not send your data to AI providers ourselves. The assistant you connect only receives what it requests from your account while you use it, and its provider’s own policy governs what happens to it next. Check the privacy policy and settings of your assistant:

Do I need a token?
Usually not. Assistants that support sign-in open the BacklinkMastery login page and you only approve. A token is for tools that cannot open that page, or when you prefer a fixed key in a configuration file.
How do I disconnect an assistant?
Revoke the connection in your profile, under AI connections. You can also remove the connector on the assistant’s side. Open AI connections
Does it work with Gemini?
Not for now: Google only lets personal accounts based in the United States add a custom connector in Gemini.

Ready to try it?

Create a free account, add your first backlinks, then connect your assistant. No credit card required.

Already have an account? Log in