# Bitly (verified)

Shorten, group, and track links. View click analytics, manage campaigns, and create branded short URLs with custom domains.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bitly

# Browse available tools
npx -y @smithery/cli@latest tool list bitly

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bitly create_short_link

# Call a tool
npx -y @smithery/cli@latest tool call bitly create_short_link '{}'
```

## Direct MCP Connection

Endpoint: `https://bitly.run.tools`

## Tools (52)

- `create_short_link` — Create a compact, shareable link with advanced customization options. This tool turns long URLs into short Bitly links …
- `expand` — Retrieve the original long URL and basic metadata for any short link. Returns the destination URL, creation timestamp, …
- `get_user` — Get authenticated user information including profile details, email addresses, 2FA status, and default group. Provides …
- `get_organizations` — Get all organizations that the authenticated user has access to. Returns organization details including organization ID…
- `link_metrics` — Retrieve click metrics and time-series data for any short link. Returns total click counts and click data over time per…
- `link_countries` — Get click metrics by country for any short link. Returns geographic breakdown of where clicks originated with click cou…
- `link_cities` — Get click metrics by city for any short link. Returns geographic breakdown of clicks at the city level. Use this to ana…
- `link_devices` — Get click metrics by device type for any short link. Returns breakdown of clicks by device type (mobile, desktop, table…
- `link_referrers` — Get click metrics by referrer source for any short link. Returns breakdown of clicks by referring websites and traffic …
- `link_referring_domains` — Get click metrics by referring domain for any short link. Returns breakdown of clicks by domain names that referred tra…
- `link_clicks_summary` — Get total click count summary for any short link. Returns aggregate click statistics without time-series data. Use this…
- `link_engagements` — Get engagement metrics (clicks + scans) over time for any short link. Returns time-series data showing engagement count…
- `link_engagements_summary` — Get total engagement counts (clicks + scans) for any short link rolled up into a summary. Returns aggregate engagement …
- `get_short_link_details` — Get complete short link information. Returns comprehensive link data including title, destination URL, creation timesta…
- `update_short_link` — Update short link properties including destination URL, title, archived status, and tags. This tool allows you to modif…
- `delete_short_link` — Delete a short link permanently. This operation removes unedited short links (non-customized links only) and cannot be …
- `get_group_details` — Get specific group information and details by group GUID. Returns comprehensive group metadata including name, organiza…
- `get_groups` — Get all groups (workspaces) that the authenticated user has access to across all organizations. Groups are collections …
- `get_group_short_links` — Get links in a specific group with filtering and pagination. Returns a list of links belonging to the specified group, …
- `get_group_short_links_sorted` — Get performance-sorted links in a group. Returns links ranked by click performance with detailed analytics metrics and …
- `get_group_links_scans_top` — Get top performing links by scan count for all links in a group. Returns details about the best performing link.
- `get_group_links_scans_over_time` — Get QR code scan metrics over time for a group. Returns time-series data showing scan counts for each time period.
- `get_group_links_scans_countries` — Get QR code scan metrics for a group broken down by country.
- `get_group_links_scans_cities` — Get QR code scan metrics for a group broken down by city. Includes the city's subregion, region, and country if availab…
- `get_custom_domains` — Get all custom domains available to the authenticated user. Returns a list of domains that can be used for link shorten…
- `get_custom_link_details` — Get complete custom link information including metadata, creation details, and override history. Custom links are short…
- `get_qr_code` — Get complete QR Code information, including metadata and creation details. Returns comprehensive QR code data including…
- `create_qr_code` — Create a new QR code. Supports both short link and long URL destinations with full customization options. Note: This do…
- `update_qr_code` — Update an existing QR code's title, customizations, or archived status.
- `get_group_qr_codes` — Get QR codes in a specific group with filtering and pagination. Returns a list of QR codes belonging to the specified g…
- `get_qr_code_image` — Return the QR code image encoded as a data URI (base64) in the requested format. Supported formats: SVG (default) and P…
- `get_qr_scan_summary` — Get QR code scan summary with total scan counts. Returns aggregated scan statistics for the QR code including total sca…
- `get_qr_scan_metrics` — Get QR code scan metrics over time. Returns time-series data showing scan counts for each time period.
- `get_qr_scans_by_country` — Get QR code scan metrics broken down by country. Returns scan counts for each country where the QR code was scanned.
- `get_qr_scans_by_city` — Get QR code scan metrics broken down by city. Returns scan counts for each city where the QR code was scanned, includin…
- `get_qr_scans_by_device` — Get QR code scan metrics broken down by device operating system. Returns scan counts for each device OS type (iOS, Andr…
- `get_qr_scans_by_browser` — Get QR code scan metrics broken down by browser. Returns scan counts for each browser type used to scan the QR code.
- `get_group_links_clicks_top` — Get top performing links by clicks for all links in a group. Returns links ranked by click performance.
- `get_group_links_clicks_over_time` — Get click metrics over time for all links in a group. Returns time-series data showing click counts for each time perio…
- `get_group_links_clicks_countries` — Get click metrics by country for all links in a group. Returns geographic breakdown of clicks by country.
- `get_group_links_clicks_cities` — Get click metrics by city for all links in a group. Returns geographic breakdown of clicks by city.
- `get_group_links_clicks_devices` — Get click metrics by device type for all links in a group. Returns breakdown of clicks by device type.
- `get_group_links_clicks_referrers` — Get click metrics by referrer source for all links in a group. Returns breakdown of clicks by referrer.
- `get_group_engagements_top` — Get top performing links by engagement for all links in a group. Returns links ranked by engagement performance.
- `get_group_engagements_over_time` — Get engagement metrics over time for all links in a group. Returns time-series data showing engagement counts for each …
- `get_group_engagements_countries` — Get engagement metrics by country for all links in a group. Returns breakdown of engagements by country.
- `get_group_engagements_cities` — Get engagement metrics by city for all links in a group. Returns breakdown of engagements by city.
- `get_group_engagements_devices` — Get engagement metrics by device type for all links in a group. Returns breakdown of engagements by device type.
- `get_group_engagements_referrers` — Get engagement metrics by referrer for all links in a group. Returns breakdown of engagements by referrers.
- `get_group_engagements_referring_networks` — Get engagement metrics by referring network for all links in a group. Returns breakdown of engagements by referring net…
- `bulk_upload_validate` — Validate a bulk upload request and obtain a signed URL and headers for uploading a CSV or XLSX file.

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*