Merge Unified's Bitly integration Merge Agent Handler's Bitly MCP server

Connect your AI Agents to Bitly in minutes

Merge lets you securely connect your agents to Bitly and thousands of tools instantly

Start building for free

Read docs

Bitly

Learn more about Merge Agent Handler

Available tools

shorten_bitlink

Shorten a long URL to a Bitlink. Simplest way to create a short link. Returns the new short URL.

create_bitlink

Create a Bitlink with full options including title, tags, and deeplinks. Use shorten_bitlink for simple URL shortening.

get_bitlink

Get details of a Bitlink by its ID (e.g., 'bit.ly/abc123'). Returns title, long URL, tags, and metadata.

update_bitlink

Update a Bitlink's title, tags, long URL, or archived status. Use get_bitlink to verify the bitlink exists.

delete_bitlink

Delete a Bitlink permanently. This cannot be undone. Use get_bitlink to verify before deleting.

expand_bitlink

Expand a short Bitlink to its original long URL. Provide the bitlink ID (e.g., 'bit.ly/abc123').

list_bsds

List all branded short domains (BSDs) available to the current user.

list_channels

List channels in a group. Channels are distribution methods for campaigns. Use list_groups to find valid group GUIDs.

list_groups

List all groups the current user belongs to. Returns group GUIDs needed for other operations.

get_group

Get details of a specific Bitly group. Use list_groups to find valid GUIDs.

update_group

Update a Bitly group's name or settings. Use list_groups to find valid GUIDs.

list_group_bitlinks

List bitlinks in a group with optional filters. Supports pagination via searchafter cursor. Use listgroups to find valid GUIDs.

get_group_tags

Get all tags used in a group. Use list_groups to find valid GUIDs.

get_group_preferences

Get preferences for a group including default domain. Use list_groups to find valid GUIDs.

update_group_preferences

Update group preferences such as default domain. Use list_groups to find valid GUIDs.

list_organizations

List all organizations the current user belongs to.

get_organization

Get details of a specific Bitly organization by GUID. Use list_organizations to find valid GUIDs.

get_organization_plan_limits

Get plan limits for an organization. Use list_organizations to find valid GUIDs.

get_current_user

Get the current authenticated Bitly user's profile including name, email, and default group.

get_platform_limits

Get platform rate limits for the current Bitly user.

validate_credential

Validate Bitly credentials by fetching the current user profile.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Bitly MCP server

What is a Bitly MCP?

It's an MCP server that connects your agents to Bitly's link management platform via tools. Your agents can invoke these tools to shorten URLs, retrieve click analytics, update link destinations, manage link groups, and more.

Bitly offers an official MCP server, but you can also use one from a third-party platform, like Merge Agent Handler.

How can I use the Bitly MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

Automated link creation on publish: When a new article or campaign asset goes live in your CMS, an agent detects the event, calls Bitly to generate a shortened and tracked URL, and posts it to the appropriate Slack channel or updates a campaign tracker

Cross-platform analytics reporting: An agent pulls click and scan data from Bitly for all links in a group, combines it with campaign performance data from a marketing tool, and delivers a weekly digest to stakeholders

Link shortening from Slack: A Slack-based agent listens for messages containing raw URLs in a designated channel, calls Bitly to create a bitlink, and replies in-thread with the shortened version

Bulk link auditing during rebrands: When a domain migration is planned, an agent lists all bitlinks in a group, checks each destination against a list of deprecated domains, and flags or updates any that need to be redirected

What are popular tools for Bitly's MCP server?

Here are some of the most commonly used tools:

create_bitlink: generates a shortened Bitly URL from a long link, with optional custom back-half and title. Use this when an agent needs to produce a trackable short URL as part of a publishing or distribution workflow
get_bitlink: fetches metadata and click statistics for a specific bitlink. Helpful when an agent needs to pull performance data for reporting or verify a link's current destination
update_bitlink: modifies a bitlink's destination URL, title, or archived state. Good for workflows that handle domain migrations or need to swap out a link target without changing the short URL
list_group_bitlinks: returns all bitlinks within a group, filterable by tag, keyword, or creation date. Call this when an agent needs to audit or process a collection of links in bulk
expand_bitlink: resolves a shortened Bitly URL back to its full original destination. Useful for agents that need to verify where a short link points before taking a downstream action
get_group_tags: retrieves all tags applied to links within a group. Use this when an agent needs to categorize or filter links by campaign, content type, or team

What makes Merge Agent Handler's Bitly MCP server better than alternative Bitly MCP servers?

Here's why teams choose Merge Agent Handler's Bitly MCP server over building their own or using another option:

Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Bitly, this means you can prevent link destination URLs, click analytics, and account details from being exposed even when the agent has broad read access

Managed authentication and credentials: Merge stores and refreshes Bitly credentials on your behalf. You never expose raw API keys or OAuth tokens to an agent or handle token rotation yourself

Real-time observability and audit trail: Every tool call made against Bitly is logged with timestamp, tool name, input parameters, and response metadata. You get a full record of what an agent created, read, or modified without any custom instrumentation

Tool Packs and controlled access: Tool Packs let you bundle specific Bitly tools with tools from other connectors into a single MCP endpoint, scoped to a specific use case. An agent gets exactly the tools it needs, nothing more

How can I start using Merge Agent Handler's Bitly MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).

2. Create a new Tool Pack, then find and enable the Bitly connector. Choose which tools to include: enable read tools like get_bitlink and list_group_bitlinks for analytics and auditing use cases, or add write tools like create_bitlink and update_bitlink if your agent needs to create or modify links.

3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.

4. From the Registered User detail page, authenticate Bitly by completing the OAuth or API key credential flow. Merge stores and manages the credentials going forward.

5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.

6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your Bitly tools are now accessible through that endpoint.