X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Short io to Claude

Connect Claude Web, Desktop and Cowork to Short io MCP. Show click stats for your latest short links, list most popular short urls this month, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Short io logoShort io
Api Key

Short.io is a URL shortening service that lets you create and manage branded short links. Easily track link performance and analytics for every campaign.

41 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Short io account to Claude via Composio Connect, enabling it to show click stats for your latest short links, list most popular short URLs this month, get OpenGraph settings for a specific link, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Short io with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Short io to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Short io account

Back in Claude, ask it to connect to Short io or give it any Short io-related task.

For example, ask Claude to:

  • "Show click stats for your latest short links"
  • "List most popular short URLs this month"
  • "Get OpenGraph settings for a specific link"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Short io account is ready to use.

What is the Short io Claude Connector, and what's possible with it?

The Short io MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Short io account. It provides structured and secure access to your branded short links, so your agent can create and manage links, retrieve analytics, organize domains, and optimize your link campaigns automatically.

  • Automated branded link creation and management: Instantly generate new short links, fetch details, update metadata, and organize your links by domain—all on demand.
  • Comprehensive click analytics and statistics: Retrieve detailed click metrics for individual links or aggregated data by domain to track performance and measure engagement.
  • Popular path and traffic insights: Analyze the most visited short link paths in your domains over time to understand which content resonates with your audience.
  • Granular permissions and access control: Check and manage user permissions on links within your domains, ensuring secure collaboration and streamlined workflows.
  • Open Graph and targeting customization: Review and adjust Open Graph properties for better link previews and set up advanced targeting rules by region or country to maximize reach.

Troubleshooting

1. Why does Claude not use the Composio connector for Short io?

The connector can show as connected, but Claude must use it in each Short io conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Short io again.

2. Why does Claude show an MCP server error before Short io connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Short io.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Short io.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Short io authorization link not work?

The Composio connector is one server. Your Short io account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Short io connection.
  • Composio creates a fresh Short io authorization link.
  • Open that link in your browser and finish the Short io sign-in.

4. Why do Short io actions fail after they worked before?

The Short io connection can expire or lose permission.

  • Ask Claude to inspect the Short io connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Short io account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Short io.
  • If the action still fails with a permission error, check that the connected account has that permission in Short io itself.

5. How do I switch to a different Short io account?

Claude can manage the Short io connection for you.

  • Ask Claude to disconnect or delete the current Short io account.
  • Ask Claude to connect Short io again.
  • Open the new Composio authorization link for Short io.
  • Sign in with the other Short io account in the browser.
  • After the account connects, ask Claude to retry the Short io task.

6. Why is my Short io connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Short io connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Short io tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Short io.
TOOLS

Supported Tools

Every Short io action and event your agent gets out of the box.

Add Tag to Links in Bulk

Tool to append a single tag to multiple short links in one call.

Archive Link

Archive a short link, hiding it from the dashboard while keeping it accessible.

Create Folder

Tool to create a new folder for organizing links within a domain.

Create Short Link

Tool to create a new short link from a long URL on your branded domain.

Delete Link

Tool to permanently delete a short link by its unique ID.

Delete Link Permission

Revokes a specific user's access permission for a short link.

Delete Links in Bulk

Delete multiple short links in a single API call (up to 150 links).

Duplicate Link

Tool to duplicate an existing short link by its ID.

Generate QR Code for Link

Tool to generate a QR code for a short link.

Get Bundle Templates

Tool to retrieve all available bundle templates.

Get Domain Details by ID

Tool to retrieve detailed information for a specific domain by its ID.

Get Domain Link Clicks

Tool to get click statistics for specific links in a domain.

Get Domain Paths

Tool to list the most popular paths in a domain over time.

Get Domain Statistics

Tool to get comprehensive statistics for a domain over a specified period.

Get Folder

Tool to retrieve folder details by ID.

Get Link by Original URL

Tool to get link info by original URL.

Get Link Countries

Tool to get country targeting rules for a short link.

Get Link Info by Link ID

Retrieves comprehensive metadata for a short link using its unique ID.

Get Link Info by Path

Tool to get link info by its path and domain.

Get Link OpenGraph Properties

Tool to retrieve OpenGraph settings for a link.

Get Link Permissions

Retrieves all user access permissions for a specific short link within a domain.

Get Link Regions by Country

Tool to list all regions available for a country.

Get Link Regions

Retrieves all region-based targeting rules configured for a specific short link.

Get Links by Original URL

Tool to get multiple links info by original URL.

Get Links List

Tool to list short links on a domain with optional filters.

Get Link Statistics

Tool to get click statistics for a specific link.

Get Link (Tweetbot)

Create a short link using the simplified Tweetbot GET endpoint.

List Domains

Tool to retrieve all domains associated with the Short.

List Folders

Tool to list all folders for a specific domain.

Post Domain Link Clicks

Tool to get click statistics for specific links in a domain using POST method.

Get Domain Statistics by Interval

Tool to retrieve domain statistics over a custom interval.

Post Domains Last Clicks

Tool to retrieve the latest raw click events for a domain.

Get Domain Statistics

Tool to get detailed statistics for a domain over a specified period.

Get Domain Top Values

Retrieves top values for a specified analytics column ranked by click count for a domain.

Archive Links in Bulk

Archive multiple short links in a single API call (up to 150 links).

Create Links in Bulk

Tool to create up to 1000 short links in one call.

Generate QR Codes in Bulk

Tool to generate QR codes for multiple links in bulk.

Unarchive Links in Bulk

Unarchive multiple short links in bulk (up to 150 links per request).

Unarchive Link

Unarchive a previously archived short link to restore it to active status.

Update Domain Settings

Tool to update domain settings for a Short.

Update Link

Tool to update an existing short link by its ID.

FRAMEWORKS

How to build Short io MCP Agent with another framework

Claude Code logo

Claude Code

Use Short io MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Short io MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Short io MCP with Claude Agent SDK

Codex logo

Codex

Use Short io MCP with Codex

OpenClaw logo

OpenClaw

Use Short io MCP with OpenClaw

Hermes logo

Hermes

Use Short io MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Short io MCP with Atomic Agent

Google ADK logo

Google ADK

Use Short io MCP with Google ADK

LangChain logo

LangChain

Use Short io MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Short io MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Short io MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Short io MCP with LlamaIndex

CrewAI logo

CrewAI

Use Short io MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Short io MCP with Pydantic AI

AutoGen logo

AutoGen

Use Short io MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Short io MCP server, the agents and LLMs can only access a fixed set of Short io tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Short io and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Short io tools.

Yes, absolutely. You can configure which Short io scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Short io data and credentials are handled as safely as possible.

Start with Short io.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Short io tool your agent needs.Free to start.

Start building