How to Connect AI Assistants to UTM.io with MCP

Connect your AI assistant to UTM.io so it can read your workspace rules, build links that follow them, find existing links, and update link details, right from a chat. It works with Claude, ChatGPT, Cursor, Claude Code, and any other AI tool that supports remote MCP servers.

MCP (Model Context Protocol) is the open standard AI assistants use to connect to other apps. You sign in with your normal UTM.io login, so there is no API key to create or share.

On this page


What your AI assistant can do

Ask it to What happens
See your workspaces Lists the workspaces you can access in the connected account, with how many links each one holds.
Learn a workspace's rules Reads each parameter and attribute: whether it is required, its saved values, its rules in plain words, and the shorteners you can use.
Use your templates Lists the workspace's templates and the values each one fills in, so links can start from your team's standard setups.
Create links Creates up to 100 links in one request. Every link is checked against your workspace rules. Links that pass are created. Links that break a rule come back with the field, the rule, and the allowed values, so the assistant can fix them and send them again.
Find links Searches a workspace by created date, exact parameter values, template, or text, newest first.
Update links Changes a link's notes and parameter or attribute values. New values must follow your rules, or nothing is changed.

Every result includes a link that opens the workspace or link in the UTM.io app, so you can check the assistant's work.

What it can't do

  • Delete links.
  • Change where an existing link sends people: its destination URL, shortener, short URL, back-half, and template stay as they are. To change those, the assistant creates a new link.
  • Change workspace settings, rules, parameters, or templates.
  • Read click counts or other analytics.
  • Invite, remove, or manage users.

Before you start

Available on: Plus, Professional, Business, and Enterprise plans. It is not included in Starter or legacy plans. See the pricing page, or contact [email protected] if you are on a legacy plan.
Who can connect: any user in an account whose plan includes it, unless an admin has turned AI agents off for the account.

  • The assistant works as you. It sees only the workspaces you can access, and the same rules apply to its links as to yours. Connecting an assistant never gives it more access than you have.
  • No API access needed. MCP is separate from the UTM.io API. You don't need API access or an API key, and API keys don't work with the MCP server.
  • You need the server URL. Every AI app asks for it:
https://mcp.utm.io/mcp

How connecting works

You add the server URL in your AI app (see the steps for each app below). The sign-in that follows is the same for every app:

  1. Your AI app opens a UTM.io page in your browser. Sign in the way you usually do: email and password, Google, or SSO. If you are already signed in to UTM.io, this step is skipped.
  2. A permission screen opens: [App name] wants to access your utm.io account.
  3. Under Team, choose the UTM.io account the assistant should work in. Only accounts where AI agents are allowed are listed. If you have just one, there is nothing to choose.
  4. Under It will be able to, choose what the assistant may do:
    • View your links: see workspaces, rules, templates, and links.
    • Create and edit links: also create links and update them. Untick this to connect read-only.
  5. Click Allow. If your account requires two-factor authentication, enter your code. If it requires SSO, you are sent through your SSO sign-in first.
  6. When you see Access allowed, go back to your AI app. You can close the browser tab.

Verified and unverified apps

Claude, Claude Code, ChatGPT, and Cursor are verified by UTM.io and show a verified mark. Any other app shows unverified next to its web address, with the warning "This app is not verified". UTM.io hasn't checked who makes it, so allow it only if you trust that app and the address shown.

Good to know

  • Each connection works in one UTM.io account. To use the assistant in another account, connect again and choose that account.
  • If you reconnect the same app to the same account with the same permissions, UTM.io may skip the permission screen.

Connect Claude (web and desktop)

Custom connectors are available on every Claude plan. The Free plan allows one custom connector. Connectors you add also work in the Claude desktop app.

Claude Free, Pro, and Max

  1. In Claude, go to Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter UTM.io as the name and https://mcp.utm.io/mcp as the URL, then click Continue.
  4. Claude detects the sign-in settings. Keep the recommended options and click Add.
  5. Sign in to UTM.io and allow access (see How connecting works). If the sign-in doesn't open, click Connect next to UTM.io in Customize > Connectors.

Claude Team and Enterprise

An owner adds UTM.io once for your whole Claude organization. Each person then connects with their own UTM.io login, so permissions stay per person.

  1. Owner: go to Organization settings > Connectors, click Add, hover over Custom, and select Web.
  2. Owner: enter UTM.io and https://mcp.utm.io/mcp, click Continue, keep the recommended sign-in options, and click Add.
  3. Each member: go to Customize > Connectors, find UTM.io, click Connect, then sign in to UTM.io and allow access.

Use it in a chat

Click the + button at the bottom left of the chat box, open Connectors, and make sure UTM.io is turned on. Claude asks before it uses a tool unless you choose to always allow it.

For more detail, see Anthropic's guide: Get started with custom connectors using remote MCP.


Connect ChatGPT

What you can do depends on your ChatGPT plan:

ChatGPT plan What works
Business, Enterprise, Edu Everything: view, create, and update links. A workspace admin or owner adds UTM.io. On Enterprise and Edu, admins can also allow selected members to add it.
Pro Read-only. ChatGPT can look up workspaces, rules, templates, and links, but can't create or update links.
Other plans Custom MCP servers aren't available.

Custom MCP servers work in ChatGPT on the web, not in the mobile apps.

Add UTM.io (Business, Enterprise, Edu)

  1. In ChatGPT on the web, open Plugins.
  2. Select the + button, then Add custom MCP server.
  3. Enter UTM.io as the name.
  4. Under Connection, enter https://mcp.utm.io/mcp.
  5. For authentication, choose OAuth.
  6. Review the risk warning and tick I understand and want to continue.
  7. Select Create as a plugin. Sign in to UTM.io and allow access when asked, then review the tools ChatGPT found.
  8. To let the rest of your workspace use it, an admin or owner publishes it for the workspace. Each member then signs in with their own UTM.io login.

Use it in a chat

Start a new chat, type @, and select UTM.io. ChatGPT may ask you to confirm before it creates or updates links.

ChatGPT keeps a snapshot of UTM.io's tools from when the app was added. When UTM.io adds or changes tools, a workspace admin may need to refresh the app's actions in ChatGPT's workspace settings.

For more detail, see OpenAI's guide: Connecting custom MCP servers in ChatGPT.


Connect Cursor

  1. Open Cursor's MCP settings on the Customize page and add a new MCP server. You can also edit the configuration file directly: ~/.cursor/mcp.json for all your projects, or .cursor/mcp.json inside one project.
  2. Add UTM.io:
    {
      "mcpServers": {
        "utm-io": {
          "url": "https://mcp.utm.io/mcp"
        }
      }
    }
    	
  3. Save. UTM.io appears in Cursor's MCP server list and asks you to sign in. Start the sign-in, then sign in to UTM.io and allow access.
  4. Make sure the UTM.io server is turned on in Customize. Cursor asks for your approval before it uses a tool.

For more detail, see Cursor's guide: Model Context Protocol (MCP).


Connect Claude Code

  1. In your terminal (not inside a Claude Code session), run:
    claude mcp add --transport http --scope user utm-io https://mcp.utm.io/mcp
    	

    --scope user makes UTM.io available in all your projects. Leave it out to add it to the current project only.

  2. Start Claude Code and run /mcp.
  3. Select utm-io and choose Authenticate. Your browser opens. Sign in to UTM.io and allow access. If the browser doesn't open, copy the address shown in the terminal into your browser.

For more detail, see Connect Claude Code to tools via MCP.


Connect another AI tool

Any AI tool that supports remote MCP servers with OAuth sign-in can connect to UTM.io. Look for an option such as "Add MCP server", "Custom connector", or "Remote server" in its settings, and use these values:

Setting Value
Server URL https://mcp.utm.io/mcp
Transport Streamable HTTP (some tools call it "HTTP" or "remote")
Authentication OAuth. Leave client ID and client secret empty: UTM.io registers the tool automatically when you sign in.
API key or headers None

After you add it, the tool opens the UTM.io sign-in, and the rest works as described in How connecting works. The permission screen marks the tool as unverified and shows its web address. Check that address before you click Allow.

It won't work with tools that only support local (stdio) MCP servers, or that can only connect with an API key or a fixed header. The UTM.io MCP server accepts OAuth sign-in only.


Things to ask your assistant

Start with your workspace and its rules, then build. A few examples:

  • "Which UTM.io workspaces can I use?"
  • "What are the link rules in the Paid Social workspace? Which fields are required, and what values are allowed?"
  • "Using the LinkedIn Ads template, create links for these five landing pages for the spring-sale campaign."
  • "Here is our launch brief. Create the tracking links for every channel in it, and show me any that UTM.io rejected and why."
  • "Find the links created last week with utm_campaign spring-sale and add the note 'Paused on May 3'."

Tip: Ask the assistant to read the workspace rules before it creates links. Most assistants do this on their own, and it means fewer rejected links.


See and revoke connected apps

Your own connections

  1. Open the profile menu and choose Edit Profile.
  2. Scroll to Connected apps. Each app shows its account (Team), its permissions (View your links, Create and edit links), when you connected it, and when it was last used.
  3. To cut an app off, click Revoke and confirm. It stops working at once. To use it again, connect it again from the AI app.

Every connection in your account (Account Owners and Admins)

  1. Open the Manage menu and choose Account Members.
  2. Scroll to Connected apps. It lists every app your members have connected to this account, with who connected it.
  3. Click Revoke next to any of them. It stops working at once.

When connections end on their own

A connection stops working, and has to be connected again, when:

  • the user is removed from the account
  • the user changes or resets their password, or an admin sets a new one for them
  • an admin turns on Require SSO (connections not made through SSO end)
  • an owner turns on two-factor authentication (connections made without 2FA end)
  • it hasn't been used for 90 days
  • 180 days have passed since it was connected

Two things pause connections instead of ending them: an admin turning AI agents off, and the account moving to a plan without MCP. Connections work again, without reconnecting, once AI agents are back on or the plan includes MCP again.


For admins: turn AI agents on or off

Who can change it: Account Owners and Account Admins
Default: on, wherever the plan includes MCP

  1. Switch to the account you want to change.
  2. Open the profile menu and choose Edit Profile.
  3. Under Authentication & Security, turn Allow AI agents (MCP) for my team off or on. The change saves right away; you don't need to click Save.

When it is off, every connected app in the account stops working at once, and nobody can connect a new one: the account no longer appears on the permission screen. Existing connections are kept: turn it back on and they work again without anyone reconnecting.


Limits and good to know

  • Rate limits. Each action the assistant takes counts toward your account's API rate limit, which it shares with any UTM.io API use. By default that is 100 actions per minute and 10,000 per day. When the limit is reached, the assistant is told how long to wait.
  • Up to 100 links per request. For bigger batches, the assistant splits them into several requests.
  • Searches are for finding, not listing. Results come newest first, 25 per page by default and up to 100. A search too broad to finish on a large workspace is refused, and the assistant is asked to narrow it by date or by parameter value. In search results, long text such as notes is cut to 200 characters.
  • No duplicate links on retry. UTM.io asks the assistant to label each link it sends. If it sends the same labeled link again within 24 hours, for example after a dropped connection, UTM.io returns the link it already created instead of making a second one.
  • Workspace rules apply, the template requirement doesn't. Required fields, allowed values, and every other rule are checked for each link. The Require template selection setting only applies to the link builder, so, as with the API, Zapier, and CSV import, links an assistant creates are not checked against it. Assistants can still use a template when you ask them to.
  • Your link content stays data. UTM.io tells assistants that notes, parameter values, and other text your team writes are content, not instructions. Still, connect only AI apps you trust, and review what the assistant plans to create before you approve it.

Troubleshooting

"[App] can't connect to your utm.io account"
None of your accounts can connect AI apps. The page shows the reason under each account. "This Team's plan doesn't include app connections" means the account needs a Plus plan or higher. "A Team admin turned off app connections" means an Account Owner or Admin needs to turn AI agents back on (see For admins).

"This connection request has expired"
Go back to your AI app and start connecting again.

"This app can't connect to utm.io"
UTM.io doesn't recognize the app or has blocked it. Contact us at [email protected] if you think this is a mistake.

"[Account] still needs you to finish two-factor verification" or "...to sign in with SSO"
Your account requires 2FA or SSO. Complete it when asked, then click Allow again.

The assistant can read links but says it can't create or edit them
You connected read-only. Revoke the app in Edit Profile > Connected apps, connect again from the AI app, and keep Create and edit links ticked. On ChatGPT Pro, connections are read-only on ChatGPT's side.

It worked before and now it doesn't
The connection was revoked, expired, or paused. See When connections end on their own, then connect again from your AI app.

The assistant says the rate limit is used up
Your account reached its API rate limit, which is shared with your API use. Wait the time the assistant mentions, then try again. If your team hits the limit regularly, contact us.

Some links were rejected
That is UTM.io's rules at work. The assistant gets the field, the rule, and the allowed values for each rejected link. Ask it to fix them and try again. If a value you need isn't allowed, ask a workspace admin to update the rules.

The assistant can't find a workspace
It only sees workspaces you can access in the account you connected. Check the workspace name, or connect again and choose the right account.


FAQ

Do I need API access or an API key?
No. You sign in with your UTM.io login. MCP is separate from the UTM.io API, and API keys don't work with it.

Which AI apps are verified?
Claude, Claude Code, ChatGPT, and Cursor. Other apps that support remote MCP servers can connect too, and are marked unverified on the permission screen.

Can I connect to more than one UTM.io account?
Each connection works in one account. To work in another, connect again and choose that account.

Can the assistant delete links or change where a link goes?
No. It can create links and update notes and parameter or attribute values, but it can't delete links or change a link's destination URL, shortener, short URL, back-half, or template.

Can it read click counts or analytics?
Not yet. Today it works with workspaces, rules, templates, and links.

Is this the same as the UTM.io API or the Zapier integration?
No. The API and Zapier are for scripts and automations. MCP is for AI assistants, signs in as you, and applies your workspace rules to every link.

Need help?

Contact us at [email protected].

Still need help? Contact Us Contact Us