Bitly MCP

Live

OAUTH 2.1

LINK MANAGEMENT

Marketing

Every shortened link, campaign tag, and click analytics record your team manages lives in Bitly. Bitly MCP gives your agent authenticated access to link data scoped to the user who authorized it.

  • Acts as the user: Access and write actions stay tied to the Bitly MCP account that authorized the agent.
  • Credentials stay vaulted: AES-256, resolved at request time, never in LLM context.
  • Scoped before every call: User permissions enforced. 90-day audit trail.
Bitly MCP
agent · Acme Q3
Run
Which of our campaign links got the most clicks this week and what were the top referrers?
S
bitlymcp_link_clicks_summary
72ms
Link management agent
Top 3 this week: Q4-launch-email (4,820 clicks, top referrers: email 78%, LinkedIn 12%), pricing-page-cta (3,110, direct 65%, Twitter 22%), webinar-reg (2,480, email 82%, Slack 11%).
Sources: 3 campaign links, this week
bitlymcpmcp
3 links
18:29
Message Claude...

Tools your link management agent reaches for on Bitly MCP, scoped per user.

CALL ANY TOOL
Shorten URLs, retrieve click stats, list and update links, and analyze referrer and geo breakdowns.
bitlymcp_bitly_bulk_upload_file
Bitly bulk upload file
Upload a file to a signed URL. Use this immediately after bitly_bulk_upload_validate to actually upload the file content, passing the upload_url and headers from that tool's response. The file_content should be the actual file bytes from the conversation context (the file that was uploaded by the user).
Parameters
Name
Type
Required
Description
file_content
string
Required
The actual file content (CSV or XLSX file bytes as a string) from the conversation context.
headers
object
Required
The headers map returned from bitly_bulk_upload_validate (as a JSON object with string keys and string values).
upload_url
string
Required
The signed upload URL returned from bitly_bulk_upload_validate.
_meta
object
Optional
Optional metadata about this request. Include user_prompt, caller_agent (e.g. claude), intent_classification, conversation_id.
content_type
string
Optional
Content type for the upload. Defaults to 'text/csv' for CSV files or 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' for XLSX files.
response_format
string
Optional
'text' (default) or 'json'
bitlymcp_bitly_create_qr_code
Bitly create qr code
bitlymcp_bitly_delete_short_link
Bitly delete short link
bitlymcp_bitly_export_data
Bitly export data
bitlymcp_bitly_get_custom_domains
Bitly get custom domains
bitlymcp_bitly_get_group_analytics
Bitly get group analytics
bitlymcp_bitly_get_group_qr_codes
Bitly get group qr codes
bitlymcp_bitly_get_groups
Bitly get groups
bitlymcp_bitly_get_link_destination
Bitly get link destination
bitlymcp_bitly_get_qr_code_analytics
Bitly get qr code analytics
bitlymcp_bitly_get_user
Bitly get user
bitlymcp_bitly_update_qr_code
Bitly update qr code
bitlymcp_bulk_upload_file
Bulk upload file
bitlymcp_create_qr_code
Create qr code
bitlymcp_get_group_details
Get group details
bitlymcp_get_group_engagements_countries
Get group engagements countries
bitlymcp_get_group_engagements_referrers
Get group engagements referrers
bitlymcp_get_group_links_clicks_cities
Get group links clicks cities
bitlymcp_get_group_links_clicks_over_time
Get group links clicks over time
bitlymcp_get_group_links_clicks_top
Get group links clicks top
bitlymcp_get_group_links_scans_over_time
Get group links scans over time
bitlymcp_get_group_short_links
Get group short links
bitlymcp_get_organizations
Get organizations
bitlymcp_get_qr_code_image
Get qr code image
bitlymcp_get_qr_scans_by_browser
Get qr scans by browser
bitlymcp_get_qr_scans_by_device
Get qr scans by device
bitlymcp_link_cities
Link cities
bitlymcp_link_devices
Link devices
bitlymcp_link_metrics
Link metrics
bitlymcp_update_qr_code
Update qr code

For more tools, view docs.

Build your Agent
Drop the toolkit in, point it at the user, and your link management agent can use Bitly MCP from the first run.
Python · LlamaIndex
import { ScalekitClient } from "@scalekit-sdk/node";
import { DynamicStructuredTool } from "@langchain/core/tools";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { z } from "zod";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["bitlymcp"], toolNames: ["bitlymcp_create_short_link", "bitlymcp_link_clicks_summary", "bitlymcp_get_group_short_links"] },
pageSize: 100,
});

const lcTools = tools.map((t) => new DynamicStructuredTool({
name: t.tool.definition.name,
description: t.tool.definition.description,
schema: z.object({}).passthrough(),
func: async (args) => {
const { data } = await sk.tools.executeTool({
toolName: t.tool.definition.name,
identifier: "user_123",
params: args,
});
return JSON.stringify(data);
},
}));

const agent = createReactAgent({ llm, tools: lcTools });
import { ScalekitClient } from "@scalekit-sdk/node";
import OpenAI from "openai";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["bitlymcp"], toolNames: ["bitlymcp_create_short_link", "bitlymcp_link_clicks_summary", "bitlymcp_get_group_short_links"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
type: "function",
function: {
name: t.tool.definition.name,
description: t.tool.definition.description,
parameters: t.tool.definition.input_schema,
},
}));

const resp = await openai.responses.create({
model: "gpt-4o", input: prompt, tools: llmTools,
});
import { ScalekitClient } from "@scalekit-sdk/node";
import Anthropic from "@anthropic-ai/sdk";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["bitlymcp"], toolNames: ["bitlymcp_create_short_link", "bitlymcp_link_clicks_summary", "bitlymcp_get_group_short_links"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
name: t.tool.definition.name,
description: t.tool.definition.description,
input_schema: t.tool.definition.input_schema,
}));

const msg = await anthropic.messages.create({
model: "claude-sonnet-4-6", max_tokens: 1024,
tools: llmTools,
messages: [{ role: "user", content: prompt }],
});
import { Agent } from "@google/adk/agents";
import {
MCPToolset, StreamableHTTPConnectionParams,
} from "@google/adk/tools/mcp";

const toolset = new MCPToolset({
connectionParams: new StreamableHTTPConnectionParams({
url: "https://mcp.scalekit.com/bitlymcp",
headers: { Authorization: `Bearer ${userScopedToken}` },
}),
});

const agent = new Agent({
name: "agent", model: "gemini-2.0-flash",
tools: await toolset.getTools(),
});
Try these prompts
Paste any prompt into your agent to start using Bitly MCP.
Links & stats
Copy the prompt
Copied
List all links created this week.
Copy the prompt
Copied
Get click stats for [bitlink] last 7 days.
Copy the prompt
Copied
Which links had the most clicks this month?
Copy the prompt
Copied
Show referrer breakdown for [link].
Action & management
Copy the prompt
Copied
Shorten [URL].
Copy the prompt
Copied
Update the title of [bitlink] to [title].
Copy the prompt
Copied
Add tag [campaign] to [bitlink].
Copy the prompt
Copied
Change destination URL of [link] to [new URL].
Reporting
Copy the prompt
Copied
Total clicks across all campaign links this month.
Copy the prompt
Copied
Top 5 links by click count.
Copy the prompt
Copied
Click trend for [link] last 30 days.
Copy the prompt
Copied
Which links drove traffic from LinkedIn?
SEE HOW AUTH WORKS
Users authorize Bitly MCP once. Their credentials stay vaulted, every call is checked, and every action is logged.
1
Authorize
Your user connects
Bitly MCP
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Bitly MCP
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Bitly MCP
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Bitly MCP
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
Same per-user auth pattern across other link management agents and MCP connectors. Working code, live demos, fork what fits.
GTM and RevOps Teams
Outbound prospecting agent
Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.
GTM and RevOps Teams
CRM AI agent
Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.
GTM and RevOps Teams
Deal intelligence agent
Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.
GTM and RevOps Teams
Competitive intelligence briefing agent
Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.
Test other agents
Same per-user auth pattern across other link management agents and MCP connectors. Working code, live demos, fork what fits.
SALES
Outbound prospecting agent
Search Apollo for ICP matches, rank them, draft personalised Gmail outreach, and log every send to Google Sheets.
GTM
CRM AI agent
Turn each Granola call transcript into a HubSpot record update, a drafted Gmail follow-up, and a Slack recap.
SALES
Deal intelligence agent
Score Gong call risk with an LLM, cross-reference the Attio record, and DM each owner their at-risk deals in Slack.
GTM
Competitive intelligence briefing agent
Scan Gong calls for competitor mentions, match each one to its Notion battlecard, and DM every affected rep a single Slack digest.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential so attribution, audit, and scope stay accurate.
// shared token
 audit → bot_service_account
 user_filter → broken

 // scalekit
 audit → user_abc
 scope → enforced ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
Bitly MCP today. Others tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions
Does the agent access Bitly MCP as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.
Where is the Bitly OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.
Can I limit what the agent is allowed to do in Bitly MCP?
Yes. Pass a tool name filter to listScopedTools so the link management agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Bitly MCP.
What happens when a user revokes Bitly MCP access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.
Can the agent access links created by other members of the Bitly organization?
Only links the authorizing user's Bitly account has access to. Organization-level visibility depends on the user's Bitly role. Links in other groups require the user to have group membership.
Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""bitlymcp"": {
""url"": ""https://mcp.scalekit.com/bitlymcp"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.bitlymcp]
url = ""https://mcp.scalekit.com/bitlymcp""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""bitlymcp"": {
""url"": ""https://mcp.scalekit.com/bitlymcp"",
""type"": ""http""
}
}
}