# Bitly — MCP server on mcp.ai
> Connect your Bitly account and use 10 tools for URL shortener straight from your AI agent. Connect with your own API key. Bitly is a link management platform for shortening, customizing, sharing, and measuring links and QR codes.

By: mcp.ai · official
Page: https://mcp.ai/bitly

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_bitly?ms=1787295900000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/bitly/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/bitly/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/bitly/skill.md
Postman collection (v2.1): https://mcp.ai/bitly/postman.json

## Tools
- bitly_delete_bitlink(bitlink: string) — Permanently delete an eligible unedited hash Bitlink.
- bitly_expand_link(bitlink: string) — Resolve a Bitlink to its current destination and destination history, when available.
- bitly_get_account_context(organization_guid?: string) — Return the authenticated Bitly user together with accessible groups and organizations needed by other tools.
- bitly_get_bitlink(bitlink: string) — Retrieve full Bitlink metadata, including destination, title, tags, archive or deletion state, and associated QR code IDs.
- bitly_get_bitlink_activity(unit?: string, view?: string, units?: integer, metric?: string, bitlink: string, unit_reference?: string) — Return paid-plan click or engagement analytics for a Bitlink as a timeline or summary. Requires Bitlink analytics entitlement.
- bitly_get_bitlink_traffic_sources(size?: integer, unit?: string, units?: integer, bitlink: string, dimension: string, unit_reference?: string) — Break down paid-plan Bitlink click analytics by country, city, device, referrer, or referring domain. Requires Bitlink analytics entitlement.
- bitly_get_usage_and_limits(group_guid?: string, endpoint_path?: string, feature_names?: string[], organization_guid: string) — Inspect monthly plan quotas, hourly endpoint budgets, and optional group feature usage before performing quota-consuming work.
- bitly_list_bitlinks(size?: integer, tags?: string[], query?: string, archived?: string, group_guid?: string, next_cursor?: string, created_after?: integer, created_before?: integer, hostname_path_query?: string) — List or search Bitlinks owned by a group, one cursor-controlled page at a time.
- bitly_shorten_link(domain?: string, long_url: string, group_guid: string, force_new_link?: boolean) — Create an ordinary Bitly short link for a long URL in a specific group.
- bitly_update_bitlink(tags?: string[], title?: string, bitlink: string, archived?: boolean) — Update safe metadata or archive state for a Bitlink; this tool does not redirect destinations or configure advanced routing.

## Example prompts
- "What can I do in Bitly?"
- "Show me a summary of my Bitly account"

## Links
Docs: https://mcp.ai/docs/mcps/bitly
Website: https://mcp.ai/mcps/bitly