# How to integrate Short io MCP with Atomic Agent ```json { "title": "How to integrate Short io MCP with Atomic Agent", "toolkit": "Short io", "toolkit_slug": "short_io", "framework": "Atomic Agent", "framework_slug": "atomic-agent", "url": "https://composio.dev/toolkits/short_io/framework/atomic-agent", "markdown_url": "https://composio.dev/toolkits/short_io/framework/atomic-agent.md", "updated_at": "2026-08-11T13:14:40.976Z" } ``` ## Introduction Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Short io. This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Short io account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions. ## Also integrate Short io with - [OpenAI Agents SDK](https://composio.dev/toolkits/short_io/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/short_io/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/short_io/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/short_io/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/short_io/framework/codex) - [OpenClaw](https://composio.dev/toolkits/short_io/framework/openclaw) - [Hermes](https://composio.dev/toolkits/short_io/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/short_io/framework/google-adk) - [LangChain](https://composio.dev/toolkits/short_io/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/short_io/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/short_io/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/short_io/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/short_io/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/short_io/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/short_io/framework/autogen) ## TL;DR ### How Atomic Agent connects to Short io Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication. Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account. ## Connect Short io to Atomic Agent ### Connect Short io to Atomic Agent - Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key. - In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart. - Ask Atomic Agent to do something in Short io. It searches Composio for the right tool. - On first use, open the sign-in link returned in the chat. Connect your Short io account, then return to Atomic Agent to continue. ### Headless setup Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file. ```bash COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY ``` ## What is the Short io MCP server, 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. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `SHORT_IO_ADD_TAG_TO_LINKS_BULK` | Add Tag to Links in Bulk | Tool to append a single tag to multiple short links in one call. Use when you need to add the same tag to multiple links efficiently. | | `SHORT_IO_ARCHIVE_LINK` | Archive Link | Archive a short link, hiding it from the dashboard while keeping it accessible. Archived links remain functional but are hidden from the dashboard view. Use this to organize or hide links without deleting them. | | `SHORT_IO_CREATE_FOLDER` | Create Folder | Tool to create a new folder for organizing links within a domain. Use when you need to organize links into categories or groups. | | `SHORT_IO_CREATE_LINK` | Create Short Link | Tool to create a new short link from a long URL on your branded domain. Use when you need to shorten a single URL. | | `SHORT_IO_DELETE_LINK` | Delete Link | Tool to permanently delete a short link by its unique ID. Use when you need to remove a short link from the system. The deletion is immediate and irreversible. | | `SHORT_IO_DELETE_LINK_PERMISSION` | Delete Link Permission | Revokes a specific user's access permission for a short link. Use this to remove a user's ability to view or manage a particular link within a domain. Requires Team plan. | | `SHORT_IO_DELETE_LINKS_BULK` | Delete Links in Bulk | Delete multiple short links in a single API call (up to 150 links). Rate limit: 1 request per second. Use this to permanently remove links - deleted links cannot be recovered. | | `SHORT_IO_DUPLICATE_LINK` | Duplicate Link | Tool to duplicate an existing short link by its ID. Creates a new link with the same properties as the original. Use when you need to clone a link configuration. | | `SHORT_IO_GENERATE_QR_CODE` | Generate QR Code for Link | Tool to generate a QR code for a short link. Use when you need to create a QR code image for a specific short link by its ID. | | `SHORT_IO_GET_BUNDLE_TEMPLATES` | Get Bundle Templates | Tool to retrieve all available bundle templates. Use when you need to list or select from predefined bundle templates for creating link bundles. | | `SHORT_IO_GET_DOMAIN_BY_ID` | Get Domain Details by ID | Tool to retrieve detailed information for a specific domain by its ID. Use when you need to fetch configuration details, settings, or metadata for a domain. | | `SHORT_IO_GET_DOMAINS_LINK_CLICKS` | Get Domain Link Clicks | Tool to get click statistics for specific links in a domain. Use when you need click counts for particular link IDs within a domain. Retrieves the number of clicks each specified link has received. Example: "Get click counts for links with IDs ['lnk_5YOn_turb6oFhe1NAosVTgOpq6', 'lnk_5YOn_WziFZJY3qcd1YDqVdRWg9'] in domain 1425403". | | `SHORT_IO_GET_DOMAINS_PATHS` | Get Domain Paths | Tool to list the most popular paths in a domain over time. Use after confirming a valid domain ID to analyze which short URL paths under that domain have received the most clicks in the given interval. | | `SHORT_IO_GET_DOMAIN_STATISTICS` | Get Domain Statistics | Tool to get comprehensive statistics for a domain over a specified period. Returns click metrics, link counts, and analytics breakdowns by referrer, social media, browser, country, city, and OS. Use when you need domain-level analytics. | | `SHORT_IO_GET_FOLDER` | Get Folder | Tool to retrieve folder details by ID. Use when you need to get information about a specific folder within a domain. | | `SHORT_IO_GET_LINK_BY_ORIGINAL_URL` | Get Link by Original URL | Tool to get link info by original URL. Use when you need to find all short links created from a specific original URL within a domain. | | `SHORT_IO_GET_LINK_COUNTRIES` | Get Link Countries | Tool to get country targeting rules for a short link. Use when you need to retrieve all country-based redirect configurations for a specific link. | | `SHORT_IO_GET_LINK_INFO_BY_LINK_ID` | Get Link Info by Link ID | Retrieves comprehensive metadata for a short link using its unique ID. Returns original URL, short URL, domain, tags, click count, UTM parameters, timestamps, and more. Use this when you have a link ID and need its full details. | | `SHORT_IO_GET_LINK_INFO_BY_PATH` | Get Link Info by Path | Tool to get link info by its path and domain. Use when you need to look up a branded short link by its path within a specific domain. | | `SHORT_IO_GET_LINK_OPEN_GRAPH_PROPERTIES` | Get Link OpenGraph Properties | Tool to retrieve OpenGraph settings for a link. Use after creating or updating a link to verify its social metadata. | | `SHORT_IO_GET_LINK_PERMISSIONS` | Get Link Permissions | Retrieves all user access permissions for a specific short link within a domain. Use this to check which users have been granted access to view or manage a particular link. Returns an empty list if no special permissions have been configured. Example: "Show me who has access to link 'lnk_5YOn_lR5wxdiv88Qo9ZRF6akPi' in domain '1425403'". | | `SHORT_IO_GET_LINK_REGION_LIST_COUNTRY` | Get Link Regions by Country | Tool to list all regions available for a country. Use when targeting links by region within a specific country. | | `SHORT_IO_GET_LINK_REGIONS` | Get Link Regions | Retrieves all region-based targeting rules configured for a specific short link. Region targeting allows you to redirect users to different URLs based on their geographic region (e.g., California, Texas) within a country. This provides more granular control than country-level targeting. Returns an empty list if no region targeting rules are configured for the link. | | `SHORT_IO_GET_LINKS_BY_ORIGINAL_URL` | Get Links by Original URL | Tool to get multiple links info by original URL. Use when you need to find all short links created from the same original URL within a domain, such as comparing campaign performance across different platforms. | | `SHORT_IO_GET_LINKS_LIST` | Get Links List | Tool to list short links on a domain with optional filters. Use after confirming the domain to retrieve or search links by criteria. | | `SHORT_IO_GET_LINK_STATISTICS` | Get Link Statistics | Tool to get click statistics for a specific link. Use when you need detailed click metrics over a specified interval. | | `SHORT_IO_GET_LINK_TWEETBOT` | Get Link (Tweetbot) | Create a short link using the simplified Tweetbot GET endpoint. This is a lightweight alternative to the standard POST link creation endpoint, designed for scenarios where GET requests are preferred (e.g., browser-based integrations, simple HTTP clients). Returns the shortened URL immediately upon success. | | `SHORT_IO_LIST_DOMAINS` | List Domains | Tool to retrieve all domains associated with the Short.io account. Use when you need to list available domains for creating short links or managing domain settings. | | `SHORT_IO_LIST_FOLDERS` | List Folders | Tool to list all folders for a specific domain. Use when you need to view all folder names and IDs to organize or filter links by folder. | | `SHORT_IO_POST_DOMAIN_LINK_CLICKS` | Post Domain Link Clicks | Tool to get click statistics for specific links in a domain using POST method. Use when you need click counts for multiple link paths with their creation dates. This POST version allows batch retrieval of link click statistics by providing an array of paths and their creation timestamps. | | `SHORT_IO_POST_DOMAINS_BY_INTERVAL` | Get Domain Statistics by Interval | Tool to retrieve domain statistics over a custom interval. Use when you need time-series click data for a specific domain over a defined time window. | | `SHORT_IO_POST_DOMAINS_LAST_CLICKS` | Post Domains Last Clicks | Tool to retrieve the latest raw click events for a domain. Use when detailed clickstream data is needed. | | `SHORT_IO_POST_DOMAIN_STATS` | Get Domain Statistics | Tool to get detailed statistics for a domain over a specified period. Use when you need comprehensive domain metrics including clicks, links, referrers, geographic data, and browser/OS breakdowns. | | `SHORT_IO_POST_DOMAINS_TOP` | Get Domain Top Values | Retrieves top values for a specified analytics column ranked by click count for a domain. Use to analyze which paths, countries, or other dimensions have the most traffic. Returns an ordered list of values with their click counts. | | `SHORT_IO_POST_LINKS_ARCHIVE_BULK` | Archive Links in Bulk | Archive multiple short links in a single API call (up to 150 links). Archived links are hidden from the dashboard but remain functional and accessible. Use this to organize or hide links without deleting them. Requires link IDs from previously created links. | | `SHORT_IO_POST_LINKS_BULK` | Create Links in Bulk | Tool to create up to 1000 short links in one call. Use when bulk shortening multiple URLs. | | `SHORT_IO_POST_LINKS_QR_BULK` | Generate QR Codes in Bulk | Tool to generate QR codes for multiple links in bulk. Use when you need to retrieve QR codes for several short links at once. | | `SHORT_IO_POST_LINKS_UNARCHIVE_BULK` | Unarchive Links in Bulk | Unarchive multiple short links in bulk (up to 150 links per request). This operation restores previously archived links to active status, making them functional and visible again. Use this when you need to restore visibility of a set of archived short links at once. The operation is idempotent - unarchiving already unarchived links succeeds without error. | | `SHORT_IO_UNARCHIVE_LINK` | Unarchive Link | Unarchive a previously archived short link to restore it to active status. Use this when you need to make an archived link visible and functional again. The operation is idempotent - unarchiving an already active link succeeds without error. | | `SHORT_IO_UPDATE_DOMAIN_SETTINGS` | Update Domain Settings | Tool to update domain settings for a Short.io domain. Use when you need to modify domain configuration such as the root redirect URL. | | `SHORT_IO_UPDATE_LINK` | Update Link | Tool to update an existing short link by its ID. Allows modifying destination URL, title, UTM parameters, password protection, expiration, tags, and various other link settings. Only specified fields are updated; omitted fields remain unchanged. Use when you need to edit any aspect of a previously created short link. | ## Supported Triggers None listed. ## Troubleshooting ### Why is my API key rejected? Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying. ### Why are Composio tools unavailable after saving a key? Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk. ### Does Composio have a free plan? The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection. ## Complete Code None listed. ## Conclusion ### Use Short io from Atomic Agent With your account connected, ask Atomic Agent to work with Short io in natural language. You can connect more apps through the same Composio integration as you need them. Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo). ## How to build Short io MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/short_io/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/short_io/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/short_io/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/short_io/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/short_io/framework/codex) - [OpenClaw](https://composio.dev/toolkits/short_io/framework/openclaw) - [Hermes](https://composio.dev/toolkits/short_io/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/short_io/framework/google-adk) - [LangChain](https://composio.dev/toolkits/short_io/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/short_io/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/short_io/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/short_io/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/short_io/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/short_io/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/short_io/framework/autogen) ## Related Toolkits - [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing. - [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages. - [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections. - [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach. - [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease. - [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration. - [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic. - [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns. - [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns. - [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active. - [Beehiiv](https://composio.dev/toolkits/beehiiv) - Beehiiv is a newsletter platform for creating and managing publications and subscribers. It helps grow audience engagement and monetize your mailing list. - [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place. - [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES. - [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns. - [BlueFox Email](https://composio.dev/toolkits/bluefox_email) - BlueFox Email is an email API for managing contacts, subscriber lists, and sending transactional and triggered messages. Use it to reliably send transactional and triggered emails and manage subscribers at scale. - [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere. - [Braze](https://composio.dev/toolkits/braze) - Braze is a customer engagement platform for managing user data, messaging, campaigns, and analytics. Use it to deliver targeted, multi-channel messaging and analyze campaign performance. - [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools. - [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps. - [BulkPublish](https://composio.dev/toolkits/bulkpublish) - BulkPublish is a social media publishing platform for managing scheduled content across multiple channels. It helps teams plan campaigns, publish consistently, and track performance in one place. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Short io MCP? 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. ### Can I use Tool Router MCP with Atomic Agent? Yes, you can. Atomic Agent 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. ### Can I manage the permissions and scopes for Short io while using Tool Router? 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. ### How safe is my data with Composio Tool Router? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)