Skip to main content
Add the Linkrunner connector to Claude and you can create your Linkrunner project, get your SDK token, and ask how your campaigns perform, all from a chat. You sign in to Linkrunner in a popup, so there is no token to copy. If you don’t have a Linkrunner account yet, you create one in the same popup. The connector address is:
Editing tools act on your live project, not a sandbox. The connector can create projects, and create and edit campaigns, funnels, domains, store listings, webhooks, and postback event mappings. A few of these send real traffic to third parties or cannot be undone. Read What the connector can change before you share the connector with a team.

​
Connect

Add the connector once. Your assistant asks you to sign in the first time it needs your Linkrunner account.
These steps are the same in Claude on the web, desktop, and mobile.
  1. Open Customize → Connectors.
  2. Select Add custom connector and name it Linkrunner.
  3. Enter https://mcp.linkrunner.io/mcp as the URL.
  4. Under Authentication, choose Sign in when needed.
  5. Under OAuth client, choose Use Claude’s published identity.
In a chat, select + → Connectors and enable Linkrunner for that conversation.The Claude Free plan allows one custom connector.On Team or Enterprise, an Owner adds the connector under Organization settings → Connectors → Add → Custom. Members then click Connect next to Linkrunner.

​
What happens when you sign in

You can ask what Linkrunner is, or search the documentation, before you sign in. Any other request needs your account. Claude then shows a Connect button in the chat.
  1. Click Connect. A window opens at auth.linkrunner.io.
  2. Sign in, or sign up if you are new, with Google or an email link.
  3. Review the consent page. It reads “claude.ai wants to access your Linkrunner account”, shows the email you signed in with, and lists what the connector can do: see your projects and reports, and create projects and make changes.
  4. Approve. The chat continues with your request.
Claude keeps you signed in and refreshes the session automatically. To end the session, disconnect or remove the connector.

​
Set up a new app from a chat

Start with a message such as:
Set up Linkrunner attribution for my app Acme Shop
Your assistant then works through these steps. It asks you to confirm before it creates anything.
1

Check your account

The assistant calls get_my_account to see which email you signed in with and whether your account can create projects. It then calls list_projects to show any projects you already have.
2

Find your app in the store

The assistant calls find_app_in_store to search the App Store or Play Store by name, or to look up a store link you paste. Confirm which listing is your app.
3

Create the project

The assistant calls create_project with the project name, company, project type (app or website), store links, report timezone, and optionally the billing currency (USD or INR). If you already have a Linkrunner billing account, the assistant asks which one the project belongs to. Check these details before you approve. The tool returns the new project ID and your SDK token.
4

Install the SDK

Add the SDK to your app with that token. The assistant can find the guide for your platform with search_documentation. In a code editor, the Linkrunner agent skills can make the code changes for you.To see the SDK token again later, ask for it. The assistant calls get_sdk_configuration.
5

Test the integration

Follow Integration testing to confirm that Linkrunner receives installs from your app.
After the project exists, every other tool works with it. If you have more than one project, name the project in your question.

​
Rules for new projects

These are the same rules the dashboard applies.
  • You need a company email to create a project. Gmail accounts can sign up and be invited to existing projects, but cannot create one. For help, contact support@linkrunner.io.
  • An app project needs a live App Store or Play Store listing. You cannot set up an app that is not published yet. Come back once its listing is live. A website-only project needs the website URL instead.
  • You can create up to 3 projects per day from an AI assistant. Only projects you created this way count.
  • To use an existing project, you must be its Admin, Owner, or Manager.
  • If you already have a billing account, you choose which one the new project uses. On your first project, a new billing account is created for you.
  • New projects get the same free allowance and billing setup as projects you create in the dashboard. See Billing.

​
What you can ask

Your assistant picks the right tool for your question. Some examples:
  • “What is Linkrunner, and does it work with Flutter?”
  • “What is my SDK token for Acme Shop?”
  • “How did my campaigns perform last week?”
  • “Compare my Meta vs Google performance for the last 7 days.”
  • “Which campaigns should I cut based on ROAS?”
  • “Why did installs drop yesterday?”
  • “How much of my growth is organic?”
  • “Where do users drop off between install and checkout?”
  • “Is my iOS link setup right? The link opens the App Store instead of my app.”
  • “Is Meta receiving my purchase events?”
The assistant can also make a defined set of changes for you:
  • “Create a Meta campaign for the Diwali sale pointing at our sneakers page.”
  • “Pause every campaign with no installs in the last 30 days.”
  • “Save a funnel for install, sign up, then purchase.”

​
Built-in prompts

The connector includes three starter prompts. Clients that support MCP prompts show them in their prompt picker:
  • Daily briefing: yesterday’s performance summary in 1-2 paragraphs.
  • Weekly review: this week vs last week, with anomalies and a keep/cut/scale recommendation list.
  • Cut list: the worst-performing active campaigns, with reasoning.
These are shortcuts. You can always ask the same questions in your own words.

​
Tool reference

Your assistant reads each tool’s description and decides which to call. You don’t need to call tools yourself. Tools that change your project are listed separately under What the connector can change. On a sign-in connection, every project tool takes the project ID, and the assistant gets it from list_projects or create_project. On a token connection, the token decides the project, and the overview and account tools are not offered.

​
Before you sign in

​
Account and setup

create_project also belongs to setup. It is listed under Projects because it creates something.

​
Project data

list_campaigns, get_channel_performance, and get_organic_performance return only the metric groups your assistant asks for (installs, spend, retention, custom events, and so on). A group that wasn’t requested is absent from the response rather than reported as zero, so the assistant never mistakes “not fetched” for “measured zero”. Ask for a metric by name and it will fetch it.

​
Setup and delivery checks

​
What the connector can read from your ad accounts

Ad-account tools are not available on a sign-in connection yet. To use them, connect with a token and turn on Read connected ad accounts when you generate it. These tools read from the Meta Marketing API and the Google Ads API using the ad accounts already connected to the project under Settings, and nothing else. They cannot change anything on Meta or Google. The catalogs behind these tools come from the networks themselves: Google’s own field schema and Meta’s official Marketing API field lists. Every name the assistant passes is checked against them before a request is made, so it cannot ask for a field that does not exist. A wrong name comes back with suggestions instead of a failed call. Almost everything the two reporting APIs expose for reading is reachable this way.

​
Which source answers which question

Linkrunner stays the source of truth, and connecting an ad account does not change any answer you already get. It adds to them. The network’s own conversion counts are still available, but always under a network_reported label. Your assistant quotes them as the network’s claim (“Meta reports 12 purchases”) rather than as the count. When the two sides disagree, it explains why (attribution window, view-through, SKAN delay, cross-network deduplication, or a campaign that is not linked) instead of picking one. A few things to know when you read network numbers:
  • They are the ad network’s numbers. Meta and Google count conversions with their own attribution windows and view-through rules. Linkrunner’s installs and sign-ups are measured differently. Your assistant reports the two side by side and will not merge them.
  • Currency and timezone come from the ad account, which may differ from your project’s display currency.
  • The last three days are provisional. Networks keep adjusting spend and conversions for a few days, so recent numbers can move.
  • Meta has no single “conversions” number. Your assistant reads the actions Meta reports (app installs, purchases, leads and so on) and names the one it is quoting.
  • Google’s “Conversions” column is not installs. It adds up every conversion action the account bids on (installs, trials, purchases). When comparing installs, the assistant uses only Google’s install conversion actions (the DOWNLOAD category, such as Android first open) and names the action it used.
  • Answers may come from a short cache. Closed date ranges are cached for a day, open ranges for ten minutes, and object lists for five minutes. The assistant mentions the age when it matters.
  • Reads are budgeted. Each token gets a daily allowance of live reads, and Linkrunner reserves part of its Google Ads quota for attribution. When a limit is hit, the assistant gets a wait time and a cached copy if one exists, instead of an error loop.
  • Meta connections expire roughly every 60 days. If your assistant reports that the connection has expired, reconnect Meta under Settings.
Only Meta and Google are covered. Accounts on other networks still appear in list_ad_accounts for campaign setup but cannot be queried. A few Google reports need a specific resource rather than a breakdown. Country uses geographic_view, age and gender use age_range_view and gender_view, and search queries use search_term_view. The assistant picks these through query_ad_network when you ask.

​
What the connector can change

Ask in plain language (“create a campaign for the Diwali sale”) and your assistant picks the right tool. Describe what you want changed, and confirm the summary it gives you before it writes.
Every tool below writes to your live account or project. Your assistant asks before making an ambiguous change, but it is worth being specific about what you want, especially for the tools marked as sending live traffic or being irreversible.

​
Projects

​
Campaigns

A deep link has to be a full URL on one of your own tracking domains, for example https://links.yourbrand.com/product/sneakers. An external URL is rejected. Ask your assistant to list your domains if you are not sure which to use.
Campaigns cannot be deleted through the connector. Pause them with edit_campaign instead.

​
Funnels

​
Domains and store listings

create_domain does not check DNS, so it will save a domain that is not pointed at Linkrunner yet, and there is no way to delete a domain through the connector. Check the spelling before you confirm. Adding a domain also creates a permanent MAIN_DOMAIN campaign that backs root-domain links and counts toward your campaign limit, and making the new domain primary changes which domain later campaigns use by default.
delete_store_listing is refused while any campaign still points at the listing, and the error names the campaigns. Remove it from those campaigns first.

​
Webhooks

Both tools deliver a real payload to your endpoint. Saving a webhook sends one by itself, because Linkrunner only stores an endpoint that answers 200 or 201, so configuring a Slack webhook posts a real message to that channel. Ask your assistant to test afterwards only if you want a second message.Replacing the URL cannot be undone. A project has one webhook, the new URL overwrites the old one, and the assistant cannot read the old value back to restore it (get_webhook hides the path, because a Slack webhook path is itself a credential). Keep a copy of the current URL before you replace it.

​
Postback event mappings

Creating or updating a mapping immediately sends a test postback to every connected account on that network (Meta, Google, TikTok, Snapchat, LinkedIn, Reddit). That puts a synthetic conversion in your real ad account, so avoid repeated edits.
An ad network’s built-in defaults also appear in list_postback_event_maps. They are always active and cannot be changed or removed. To override one, add your own mapping for the same event.

​
Connect with a token (existing setups and ChatGPT)

Connections made with a dashboard token keep working. Use a token for ChatGPT, for Codex CLI, or when you need the ad-account tools. A token connection is fixed to one project.

​
Prerequisites

  • A project on Linkrunner that you have access to.
  • The Admin or Member role on that project. Influencers cannot mint MCP tokens.
  • Editing tools run as the person who created the token, using that person’s project permissions. A role that cannot edit in the dashboard cannot edit through the connector either.

​
1. Generate a token

  1. Open the Linkrunner dashboard and switch to the project you want to connect.
  2. Click MCP in the sidebar.
  3. Choose what the token may do:
  4. Click Generate Token.
  5. The dashboard shows a one-time Server URL with the token already embedded as a query parameter. Copy it now. The full URL will not be shown again.
Capabilities are fixed once a token exists. To change them, generate a new token and revoke the old one. Tokens created before capabilities existed keep read and change access, and no ad-account access.
The URL contains the token as a query parameter. Treat it like a password: don’t paste it into shared documents, screenshots, or chat threads. Revoke it from the dashboard if it leaks, and generate a new one.

​
2. Connect your client

Choose your client in the dashboard to see its setup instructions. The token is part of the Server URL, so no separate authentication step is needed. Choose a client for the Linkrunner MCP connection
Copy the command under Register the Linkrunner MCP server and run it in a terminal:
Start a new Claude Code session and run /mcp to verify the connection.
You only need one connection per client and project. If you manage several Linkrunner projects, generate a token for each project and add a separate connection with a clear name. Tokens are scoped to a single project.
Open a new chat or CLI session, make sure Linkrunner is enabled, and ask one of the questions under What you can ask.

​
Manage tokens

Click MCP in the sidebar to see all active tokens for the project. For each token you can see:
  • A masked preview of the token.
  • The date it was created.
  • The user who created it.
  • The last time it was used (helps spot stale tokens).
Each token also shows its capabilities: Read, Changes, and Ad accounts. Click the trash icon next to a token to revoke it. Anyone using that token will be disconnected immediately. Revocation is not reversible. Mint a new token if you need to reconnect. A project can have up to 10 active tokens at any time. If you hit the cap, revoke an unused token before creating a new one.

​
Security

​
Sign-in connections

  • You sign in on auth.linkrunner.io. Before the connector gets access, a consent page shows which app is asking, the email you signed in with, and what the connector can do.
  • The connection acts as you. It can use the projects where you are an Admin, Owner, or Manager, and it can create new projects in your account.
  • It can make the changes listed under What the connector can change. It cannot read your ad accounts.
  • To revoke access, disconnect or remove the Linkrunner connector in your assistant. That ends the session.

​
Token connections

  • Tokens are scoped to a single project. They cannot read or change other projects you are a member of, even when the same person created the token.
  • Editing tools run as the person who created the token and apply that person’s project role, so the connector cannot do anything that person could not do in the dashboard.
  • Every change made through the connector is recorded with the action, the token, the person who created it, and what was changed. Every ad-account read is recorded the same way, with the account, the query type and the date range, but never the returned data.
  • Ad-account access is read-only and opt-in per token. The Meta and Google credentials stay on Linkrunner’s servers; the connector never receives them, and they are removed from every response and log.
  • An ad-account token can only reach accounts connected to its own project. Passing another project’s account is refused.
  • Tokens are revocable from the dashboard at any time. The per-project cap of 10 tokens limits the blast radius if one leaks.
If you only want someone to read, turn off Make changes in Linkrunner when you generate their token. A read-only token does not even list the editing tools, so the assistant cannot attempt a change with it.

​
Both connection types

  • The connector cannot delete campaigns, funnels, domains, or projects, cannot manage members, and cannot disconnect an ad-network account. Those stay in the dashboard.
  • The webhook URL is never fully readable. get_webhook returns the host but hides the path, because a Slack webhook path is a credential in itself.
  • SDK private keys, billing settings, and admin actions are not exposed.
  • To improve the connector, Linkrunner records basic usage for each call: the tool used, whether it worked, how long it took, the names of the arguments (not their values), the AI app you use, and the token, project, and person it belongs to. Returned data is never recorded.
  • Error messages and a short summary of what you asked (your assistant may send one with a call) are recorded with emails, links, phone numbers, and long IDs hidden. Names and other plain text are kept as written, so avoid putting personal or confidential details in your prompts.
  • Usage records are kept for one year.

​
Troubleshooting

The assistant says a Gmail account cannot create a project. You need a company email to create a project. Gmail accounts can still sign up and be invited to existing projects. Linkrunner keeps you signed in, so first sign out: open the dashboard and sign out. Then disconnect Linkrunner in your assistant, connect again, and sign in with your company email. If you only have a personal email, contact support@linkrunner.io. The assistant says your app needs a live store listing. An app project needs a published App Store or Play Store listing, and the assistant will not create a website project in its place. If your app is not published yet, come back once the listing is live. If the app is published, paste its store link into the chat so the assistant can look it up directly. The assistant says you reached the project limit. You can create up to 3 projects per day from an AI assistant. Try again the next day, or create the project in the dashboard. The assistant says you do not have access to a project. A sign-in connection can only use projects where you are an Admin, Owner, or Manager. Ask an Admin of that project to change your role, then ask again. Claude shows Connect again, or Claude Code asks you to sign in. The session ended, for example because the connector was disconnected. In Claude, click Connect and sign in. In Claude Code, run /mcp and sign in. The client says “Couldn’t reach the MCP server.” On a token connection, the token may have been revoked or the URL may be malformed. Generate a new token, copy the full URL exactly, and reconnect Linkrunner. On a sign-in connection, check that the URL is https://mcp.linkrunner.io/mcp. The client does not show Linkrunner tools. Make sure Linkrunner is enabled in the current chat or session. Open the client’s app, tool, or connector menu and turn it on. New chats do not always inherit connector state from previous chats. Numbers don’t match the dashboard. The connector reads the same data the dashboard does. If you see a mismatch, check that you and the assistant are using the same project, date range, and timezone, and that any filters (network, platform) match. Linkrunner’s ingestion is real-time, so there’s no lag to account for. Generating a token returns “Maximum of 10 active tokens reached.” You’re at the per-project cap. Revoke an unused token from the same settings page before creating a new one. The assistant says your deep link was rejected. A deep link has to be a full URL on one of your own tracking domains. An external address such as https://example.com/promo is refused, and so is a bare path such as /promo. Ask the assistant to list your domains and rebuild the URL on one of them. Saving a webhook fails with “Endpoint needs to return a status code of 200”. Linkrunner only stores an endpoint that answers 200 or 201 to the sample payload, and it must answer directly rather than redirecting. An endpoint that returns 202 or 204 cannot be saved. The assistant says it cannot read your ad accounts. Ad-account tools need a token generated with Read connected ad accounts. Sign-in connections do not offer them yet. Generate a token with that option turned on and add it as a separate connection. Capabilities cannot be added to an existing token. The assistant says the Meta or Google connection has expired. The stored ad-network credential is no longer valid. Open Settings, reconnect the account, and ask again. Meta connections expire on their own roughly every 60 days. The assistant says it has to wait before reading the ad account again. A rate limit or daily allowance was reached, either on the ad network or on the token. The assistant is given a wait time and uses a cached answer when one exists. Ask again after the wait, or narrow the question so fewer live reads are needed. Ad-network spend does not match the spend Linkrunner shows. The two are expected to differ. Ad-account tools return what Meta or Google report for the ad account, in the account’s currency and timezone. Linkrunner’s campaign spend is synced periodically and shown in your display currency. Ask your assistant for both and it will label which is which. The assistant cannot rename a custom channel. Renaming needs the channel’s internal id, which the assistant only sees right after it creates or edits a campaign. In a later chat it has no way to look the id up. Rename the channel in the dashboard instead.
Asking the assistant to rename a channel by editing the campaign does something different. It points the campaign at a new channel and leaves the old one behind, which changes the channel’s reporting name and splits its history.

​
What this is not

  • Not a full write API. The connector can make the changes listed above, and nothing else. Use the Linkrunner data API for programmatic writes.
  • Not a way to delete things. Campaigns, funnels, domains, and projects can only be deleted from the dashboard.
  • Not a way to edit ads. The ad-account tools read from Meta and Google; they cannot pause a campaign, change a budget, or edit targeting there.
  • Not a generic SQL/Postgres bridge. It calls the same endpoints the dashboard uses, with the same access controls.
  • Not a substitute for webhooks. Use webhooks for real-time install and signup notifications.
Need help? Contact support@linkrunner.io