Analytics

Bitly MCP Server

Use Studio chat to drive this server — credentials stay in your workspace.

Bitly is a URL shortening and link management platform with rich analytics. Shorten URLs, organize links with campaigns and channels, track click performance by geography/device/referrer, and manage branded short domains.

31 tools
Agent guide included
API Key or One-click sign in
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Bitly — workflow patterns, data models, and gotchas for your AI agent.

Bitly

Bitly is a URL shortening, QR code, and link management platform. Shorten URLs, create branded QR codes, organize links into campaigns and channels, track click/engagement analytics by geography, device, and referrer, and manage branded short domains (BSDs).

Entity Hierarchy

  • Organization → top-level account container, has organization_guid. Owns plan limits.
  • Group → subdivision within an org, has group_guid. Every user belongs to at least one group. All bitlinks and QR codes live in a group.
  • Bitlink → a shortened URL, identified by domain/hash (e.g. bit.ly/abc123). The id field is this same format.
  • Custom Bitlink → a branded vanity URL on a BSD (e.g. yourco.link/campaign). Attached to an existing bitlink.
  • QR Code → a scannable code linked to a URL. Customizable dot patterns, colors, corners. Has a qr_code_id.
  • Campaign → organizes links for marketing, has guid. Scoped to a group.
  • Channel → distribution channel within a campaign, has guid. Scoped to a group.
  • BSD (Branded Short Domain) → custom domain for branded links (e.g. yourco.link). Assigned to groups.

Workflows

Shorten a URL

Provide the long URL. Optionally specify a group, domain, title, and tags. Returns the new bitlink with its short URL.

Create branded vanity URLs

First shorten, then attach a custom keyword on a BSD with the custom bitlinks tool. E.g. map yourco.link/launch to bit.ly/3xYzAbc. List BSDs first to know which domains are available.

Create QR codes

Create customizable QR codes for any URL. Configure dot patterns (circle, blob, diamond, etc.), corner shapes, colors, and gradients. QR codes auto-shorten their destination URL.

Get a link dashboard

Use the link dashboard tool for a one-call overview: metadata + click summary + engagement summary in a single response.

Analyze link performance

Get click counts over time with configurable time windows. Drill into geographic breakdowns (country, city), device types, and referrer sources for any bitlink or across an entire group.

Organize with campaigns

Create campaigns to group related links. Assign channels (distribution sources like email, social, etc.) to campaigns. Filter bitlinks by campaign or channel.

Discover account structure

List organizations, then groups within them. Groups expose their BSDs, preferences, shorten counts, and feature usage limits. Use plan limits to understand what actions are available before attempting them.

Time-Range Parameters (Analytics)

Analytics tools accept:

  • unit — granularity: minute, hour, day, week, month (default: day)
  • units — number of time units to query; -1 returns all available data (default: -1)
  • unit_reference — ISO-8601 timestamp for the end of the range (default: now)

Gotchas

  • group_guid required: Most list/create operations are group-scoped. Always resolve the user's default group first.
  • Bitlink ID format: Always domain/hash (e.g. bit.ly/3xYzAbc), not just the hash—use the same compound id for analytics and edits.
  • Custom bitlink format: yourdomain.com/keyword — the domain must be a BSD on the account.
  • QR codes require group_guid: Pass the group when creating. Get QR code image URLs from the response.
  • Monthly shorten limits: Bitly enforces per-account monthly caps. Use the plan limits tool to check before shortening in bulk.
  • BSD DNS: Creating links on a custom domain requires DNS to be properly configured; otherwise DNS_CONFIGURATION_ERROR.
  • Pagination: Long bitlink catalogs use cursor-style paging (not simple numeric offsets).
  • Rate limits: Heavy bursts may be throttled; some analytics require higher vendor tiers and return upgrade prompts when blocked.

Tools in this Server (31)

Bitly Add Custom Bitlink

Add a custom keyword (vanity back-half) to an existing bitlink using a Branded Short Domain. For example, map 'yourco.link/campaign2026' to 'bit.ly/3x...

Bitly Bulk Update Bitlinks

Bulk update up to 100 bitlinks at once. Either archive/unarchive them or add/remove tags. Set action to 'archive' with archive=true/false, or 'edit_ta...

Bitly Create Qr Code

Create a branded QR code for any URL. Customize dot pattern, colors, and corner shapes. The URL is automatically shortened. Returns the QR code metada...

Bitly Delete Bitlink

Permanently delete a bitlink. This cannot be undone. Only unedited hash bitlinks can be deleted. Custom bitlinks and edited links cannot be deleted.

Bitly Delete Qr Code

Delete a QR code. Only works on QR codes that have not been scanned and are not for custom links. Also deletes the associated bitlink if applicable. T...

Bitly Expand Link

Expand a short bitlink back to its original long URL. Returns the short link, long URL, and creation date.

Bitly Get Bitlink Clicks

Get click counts for a bitlink over time. Returns clicks per time period (day, hour, etc.). Set summary=true to get a single total_clicks count instea...

Bitly Get Bitlink Engagements

Get engagement counts for a bitlink — includes clicks, QR code scans, and button clicks. Returns a time series by default; set summary=true for rolled...

Bitly Get Bitlink Metrics

Get a consolidated analytics report for a bitlink in one call. Returns breakdowns by country, city, device type, and referrer source — much more effic...

Bitly Get Bitlinks

Get bitlinks. Pass bitlink (e.g. 'bit.ly/3xYzAbc') to retrieve a single link with full details, or pass group_guid to list bitlinks in a group with op...

Bitly Get Bsds

List all Branded Short Domains (BSDs) available on your account. BSDs are custom domains like yourco.link used for branded short links.

Bitly Get Campaigns

Get campaigns. Pass campaign_guid to retrieve a single campaign with full details, or omit to list all campaigns. Optionally filter by group_guid. Ret...

Bitly Get Channels

Get channels. Pass channel_guid to retrieve a single channel, or omit to list channels. Optionally filter by group_guid or campaign_guid. Channels rep...

Bitly Get Custom Bitlink

Get details and redirect history for a custom bitlink (branded vanity URL). Returns the current destination bitlink, full redirect history with timest...

Bitly Get Feature Usage

Get current feature limit usage for a group. Shows how many links, QR codes, and other resources have been used against the account's plan limits.

Bitly Get Group Clicks

Get click counts over time for all bitlinks in a group. Returns a time series with timestamp and count per period.

Bitly Get Group Metrics

Get a consolidated analytics report for all links in a group in one call. Returns breakdowns by country, city, device type, referrer, and referring ne...

Bitly Get Group Preferences

Get preferences for a group, including the default domain preference for shortening.

Bitly Get Groups

Get groups. Pass group_guid for a single group's details, or omit to list all groups. Returns group name, GUID, organization, BSDs, role, and active s...

Bitly Get Group Tags

List all tags currently in use within a group (max 1000). Useful for discovering available tags before filtering bitlinks by tag.

Bitly Get Group Top Links

Get the top performing bitlinks in a group sorted by click count. Returns link details plus click counts for each link in the time period.

Bitly Get Link Dashboard

Get a complete dashboard for a bitlink in one call. Returns the link's metadata (title, long URL, tags, creation date, archived status) plus a click s...

Bitly Get Organizations

Get organizations. Pass organization_guid for details, or omit to list all. Returns organization name, GUID, tier, and creation date.

Bitly Get Plan Limits

Get all plan limits and current usage counts for an organization. Shows limits for links, custom links, QR codes, campaigns, and API calls — essential...

Bitly Get Qr Codes

Get QR codes. Pass qr_code_id for a single QR code's details (including image URL), or pass group_guid to list all QR codes in a group. Returns QR cod...

Bitly Get Shorten Counts

Get link creation velocity over time — how many links were shortened per time period. Pass organization_guid for org-wide counts, or group_guid for a ...

Bitly Shorten Link

Shorten a long URL into a Bitlink. Returns the new short URL, bitlink ID, and metadata. Optionally specify a custom domain (BSD), group, title, and ta...

Bitly Update Qr Code

Update a QR code's title, tags, archive status, or visual customizations (dot pattern, colors, corner shapes). Returns the updated QR code metadata.

Bitly Upsert Bitlink

Create a new bitlink or update an existing one. To create: provide long_url (required), plus optional domain, group_guid, title, tags. To update: prov...

Bitly Upsert Campaign

Create a new campaign or update an existing one. To create: provide name and group_guid. To update: provide campaign_guid plus fields to change.

Bitly Upsert Channel

Create a new channel or update an existing one. To create: provide name and group_guid. To update: provide channel_guid plus fields to change.

Frequently Asked Questions

What is the Bitly MCP server?

Bitly is a URL shortening and link management platform with rich analytics. Shorten URLs, organize links with campaigns and channels, track click performance by geography/device/referrer, and manage branded short domains. It provides 31 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Bitly to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/bitly. Authentication is handled automatically.

How many tools does Bitly provide?

Bitly provides 31 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Bitly require?

Bitly uses API Key or One-click sign in. Bitly requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Bitly to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/bitly

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to chat with Bitly?

Same flow: Studio opens on this server after sign-in. Keep chatting to call tools from the conversation.

Bitly MCP Server & Skill — 31 Tools