# Bitly MCP

> Connects to Bitly via Scalekit MCP to create short links, QR codes, bulk uploads, custom domains, and group analytics.

**URL:** https://caywork.com/learn/docs/node/bitlymcp-node

## Content

The **Bitly MCP Node** integrates securely with Bitly's link management API through the Scalekit MCP gateway. It enables your AI agent to create and manage short links, generate QR codes, run bulk uploads, inspect custom domains, and retrieve group-level engagements, clicks, and scans analytics.

## Parameters

### Required Parameters
* **action** (string): The target Bitly MCP tool action to run. Must be one of the enabled actions:
  * `bitlymcp_bulk_upload_file`: Bulk upload file.
  * `bitlymcp_bulk_upload_validate`: Validate a bulk upload.
  * `bitlymcp_create_qr_code`: Create a QR code.
  * `bitlymcp_create_short_link`: Create a short link.
  * `bitlymcp_create_short_link_with_qr`: Create a short link with QR code.
  * `bitlymcp_delete_short_link`: Delete a short link.
  * `bitlymcp_expand`: Expand a short link.
  * `bitlymcp_get_custom_domains`: Retrieve custom domains.
  * `bitlymcp_get_custom_link_details`: Retrieve custom link details.
  * `bitlymcp_get_group_details`: Retrieve group details.
  * `bitlymcp_get_group_engagements_cities`: Retrieve group engagements by city.
  * `bitlymcp_get_group_engagements_countries`: Retrieve group engagements by country.
  * `bitlymcp_get_group_engagements_devices`: Retrieve group engagements by device.
  * `bitlymcp_get_group_engagements_over_time`: Retrieve group engagements over time.
  * `bitlymcp_get_group_engagements_referrers`: Retrieve group engagement referrers.
  * `bitlymcp_get_group_engagements_referring_networks`: Retrieve group referring networks.
  * `bitlymcp_get_group_engagements_top`: Retrieve top group engagements.
  * `bitlymcp_get_group_links_clicks_cities`: Retrieve group link clicks by city.
  * `bitlymcp_get_group_links_clicks_countries`: Retrieve group link clicks by country.
  * `bitlymcp_get_group_links_clicks_devices`: Retrieve group link clicks by device.
  * `bitlymcp_get_group_links_clicks_over_time`: Retrieve group link clicks over time.
  * `bitlymcp_get_group_links_clicks_referrers`: Retrieve group link click referrers.
  * `bitlymcp_get_group_links_clicks_top`: Retrieve top group link clicks.
  * `bitlymcp_get_group_links_scans_cities`: Retrieve group link scans by city.
  * `bitlymcp_get_group_links_scans_countries`: Retrieve group link scans by country.
  * `bitlymcp_get_group_links_scans_over_time`: Retrieve group link scans over time.
  * `bitlymcp_get_group_links_scans_top`: Retrieve top group link scans.
  * `bitlymcp_get_group_qr_codes`: Retrieve group QR codes.
  * `bitlymcp_get_group_short_links`: Retrieve group short links.
  * `bitlymcp_get_group_short_links_sorted`: Retrieve group short links sorted.

### Optional Parameters
* **params** (object): A key-value dictionary containing action-specific inputs (e.g., `{'group_guid': '...', 'link': '...'}`).

## Practical Use Cases
1. **Campaign link management**: Create branded short links and QR codes for campaigns and track their clicks and scans.
2. **Analytics reporting**: Pull group-level engagement, click, and scan data by geography, device, referrer, and time period.