short-io

v0.1.0

Short.io link management under your own API key - create, edit, search and measure short links through Short.io's hosted MCP tools, plus a CLI that lists every link on a domain, checks what a slug really points at, bulk-creates from CSV with duplicate detection, and deletes. Activates for: (1) creating or editing a short link, (2) finding which slug points where, (3) bulk link creation from a spreadsheet, (4) auditing a short domain, (5) click and referrer statistics, (6) first-run key setup.

Claude Code7 Skills1 MCP serverstdio

By Julian DickieLicense: MIT0 GitHub starsUpdated last week

Directory evidence

Runtimes: Claude Code
Parsed components: 8 skill or MCP entries
Source updated: Sep 16, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install short-io for Claude Code

Installs for the current user

claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install short-io@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/juliandickie/short-io-plugin

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

short-io/

├── .claude-plugin/plugin.json
├── skills/audit-links/SKILL.md
├── skills/bulk-links/SKILL.md
├── skills/create-link/SKILL.md
├── skills/link-stats/SKILL.md
├── skills/setup/SKILL.md
├── skills/short-io/SKILL.md
├── skills/short-io-api/SKILL.md
└── .mcp.json

Included Skills7

audit-linksskills/audit-links/SKILL.md

Audit a short domain - list every link with the true total, check what one or many slugs really point at (configured destination, live hop, whether the domain has a 404 or a silent fallback), and reconcile a list of destinations against the account to find which already have short links. Use when the user says which slugs exist, is this link live, what does this slug point to, find the short link for, audit the domain, or reconcile this list.

bulk-linksskills/bulk-links/SKILL.md

Create many short links from a CSV or JSON file unattended - dry-run scope table first, then create with dedupe by slug and by destination, paced under the rate limit, with a results CSV and counts. Use when the user says bulk, batch, create all of these, the whole spreadsheet, or the link list.

create-linkskills/create-link/SKILL.md

Create one short link with duplicate checks - refuse a taken slug, report an existing link with the same destination, add title, tags and UTM fields, then verify the configured destination. Use when the user says shorten this, make a short link, give me a slug for, create a vanity link, or add UTMs to a link.

link-statsskills/link-stats/SKILL.md

Click statistics for a short link or a whole domain over a period - totals, top countries, referrers, browsers, UTM campaigns, and top links, through the Short.io MCP statistics tools. Use when the user asks how many clicks, where the clicks came from, which links performed, or for a period report on a short domain.

setupskills/setup/SKILL.md

First-run setup for the Short.io plugin - create a SECRET API key, choose how it is supplied (SHORT_IO_API_KEY or the plugin config field, the 0600 config file for unattended use, or a 1Password reference), remove a stale user-scope MCP entry so tools do not double up, then verify with the plugin's short-io whoami.

short-ioskills/short-io/SKILL.md

Overview and router for the Short.io plugin. Use when the user mentions Short.io, short links, a branded short domain, a slug, a vanity link, UTM-tagged links, bulk link creation, or link click stats. Explains the two ways in (hosted MCP tools for create, edit, search and statistics; the short-io CLI for full enumeration, destination checks, bulk with dedupe, and delete), the id rules, and the quirks.

short-io-apiskills/short-io-api/SKILL.md

Reference for the Short.io REST endpoints the CLI uses, the hosted MCP server and its 14 tools with argument quirks, rate limits per endpoint family, error body shapes, the silent-dedupe behaviour of link creation, and the short-io CLI command table. Loaded when any skill or request needs an endpoint, a parameter, a tool name, or an exit code.

MCP servers1

short-iostdio

command: node
args: ${CLAUDE_PLUGIN_ROOT}/scripts/run-mcp.mjs
env.SHORT_IO_API_KEY: ${user_config.short_io_api_key}
env.SHORT_IO_KEY_OP_REF: ${user_config.short_io_key_op_ref}
env.SHORT_IO_OP_ACCOUNT: ${user_config.short_io_op_account}
env.SHORT_IO_PLUGIN_DATA: ${CLAUDE_PLUGIN_DATA}
env.CLAUDE_PLUGIN_ROOT: ${CLAUDE_PLUGIN_ROOT}

MCP configuration uses runtime-provided plugin path placeholders such as ${PLUGIN_ROOT} or ${CLAUDE_PLUGIN_ROOT}. Review the manifest for the runtime-specific expansion rules.

Plugin manifests1

.claude-plugin/plugin.json

{
  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
  "name": "short-io",
  "version": "0.1.0",
  "description": "Short.io link management under your own API key - create, edit, search and measure short links through Short.io's hosted MCP tools, plus a CLI that lists every link on a domain, checks what a slug really points at, bulk-creates from CSV with duplicate detection, and deletes. Activates for: (1) creating or editing a short link, (2) finding which slug points where, (3) bulk link creation from a spreadsheet, (4) auditing a short domain, (5) click and referrer statistics, (6) first-run key setup.",
  "author": {
    "name": "Julian Dickie"
  },
  "license": "MIT",
  "keywords": [
    "short.io",
    "short-links",
    "url-shortener",
    "utm",
    "link-management"
  ],
  "mcpServers": "./.mcp.json",
  "userConfig": {
    "short_io_api_key": {
      "type": "string",
      "title": "Short.io API Key",
      "description": "A SECRET key (starts with sk_) from app.short.io/settings/integrations/api-key with the Public key toggle OFF. Optional - the config file ~/.config/short-io-plugin/config.toml, the SHORT_IO_API_KEY env var, or a 1Password reference can supply it instead. See /short-io:setup.",
      "sensitive": true,
      "required": false
    },
    "short_io_key_op_ref": {
      "type": "string",
      "title": "1Password Secret Reference",
      "description": "Optional. op://Vault/Item/field pointing at the API key. Read via the op CLI at server start when no direct key is configured. A pointer, not a secret."
    },
    "short_io_op_account": {
      "type": "string",
      "title": "1Password Account",
      "description": "Optional. Sign-in address (yourteam.1password.com) when the op CLI is signed in to more than one account."
    }
  }
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[short-io on Agent Plugins Marketplace](https://pluginsmp.com/plugins/short-io)