# Short Io — MCP server on mcp.ai
> Connect your Short Io account and use 41 tools for URL shortener straight from your AI agent. Connect with your own API key. Short.io is a URL shortening service that allows users to create branded short links, manage them, and track their performance.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_short_io?ms=1787293560000
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/short_io/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/short_io/<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/short_io/skill.md
Postman collection (v2.1): https://mcp.ai/short_io/postman.json

## Tools
- short_io_add_tag_to_links_bulk(tag: string, link_ids: string[]) — 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(link_id: string, domain_id?: string) — 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 dele
- short_io_create_folder(name: string, domainId: integer) — 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(path?: string, title?: string, domain: string, originalURL: string, allowDuplicates?: boolean) — 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(link_id: string) — 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(link_id: string, user_id: string, domain_id: string) — 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(link_ids: string[]) — 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(link_id: string) — 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(type?: string, link_id: string) — 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() — 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(domainId: integer) — 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_domain_statistics(period?: string, endDate?: integer, domainId: string, tzOffset?: string, startDate?: integer, clicksChartInterval?: string) — 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 w
- short_io_get_domains_link_clicks(ids: string[], domainId: integer) — 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. Ex
- short_io_get_domains_paths(tz?: string, period?: string, endDate?: string, domainId: integer, startDate?: string) — 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_folder(domain_id: string, folder_id: string) — 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(domain: string, originalURL: string) — 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(linkId: string) — 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(link_id: string, domain_id?: string) — 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 I
- short_io_get_link_info_by_path(path: string, domain_id: string) — 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(linkId: string, domainId: integer) — 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(link_id: string, domain_id: string) — 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
- short_io_get_link_region_list_country(country: string) — Tool to list all regions available for a country. Use when targeting links by region within a specific country.
- short_io_get_link_regions(linkId: string) — 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, Tex
- short_io_get_link_statistics(tz?: string, linkId: string, period?: string, endDate?: string, skipTops?: boolean, startDate?: string, clicksChartInterval?: string) — 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(path?: string, title?: string, domain: string, urlOnly?: boolean, originalURL: string) — 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 (
- short_io_get_links_by_original_url(domain: string, originalURL: string) — 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 p
- short_io_get_links_list(limit?: integer, folderId?: string, idString?: string, afterDate?: string, createdAt?: string, domain_id: integer, pageToken?: string, beforeDate?: string, dateSortOrder?: string) — 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_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(domainId: integer) — 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(endDate?: string, domainId: integer, startDate?: string, pathsDates: object[]) — 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 retrieva
- short_io_post_domain_stats(tz?: string, period?: string, endDate?: string, exclude?: object, include?: object, domainId: integer, skipTops?: boolean, startDate?: string, clicksChartInterval?: string) — 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_by_interval(tz?: string, period?: string, endDate?: string, domainId: integer, startDate?: string) — 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(tz?: string, limit?: integer, period?: string, endDate?: string, exclude?: object, include?: object, domainId: integer, afterDate?: string, startDate?: string, beforeDate?: string) — Tool to retrieve the latest raw click events for a domain. Use when detailed clickstream data is needed.
- short_io_post_domains_top(limit?: integer, column: string, domainId: integer) — 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 v
- short_io_post_links_archive_bulk(link_ids: string[], domain_id?: string) — 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 delet
- short_io_post_links_bulk(links: object[], domain: string, allowDuplicates?: boolean) — Tool to create up to 1000 short links in one call. Use when bulk shortening multiple URLs.
- short_io_post_links_qr_bulk(size?: integer, type?: string, color?: string, linkIds: string[], domainId?: string, noExcavate?: boolean, backgroundColor?: string, useDomainSettings?: boolean) — 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(linkIds: string[]) — 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 ne
- short_io_unarchive_link(link_id: string, domain_id?: string) — 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 al
- short_io_update_domain_settings(domainId: string, rootRedirect?: string) — 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(ttl?: string, path?: string, tags?: string[], title?: string, linkId: string, skipQS?: boolean, utmTerm?: string, archived?: boolean, cloaking?: boolean, password?: string, splitURL?: string, createdAt?: string, expiresAt?: string, iphoneURL?: string, utmMedium?: string, utmSource?: string, androidURL?: string, expiredURL?: string, utmContent?: string, clicksLimit?: integer, originalURL?: string, utmCampaign?: string, redirectType?: integer, splitPercent?: integer, integrationFB?: string, integrationGA?: string, integrationGTM?: string, passwordContact?: boolean, integrationAdroll?: string) — 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 

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

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