短.在线

Official9 tools

by xn--s7y

Short links + QR tracking URLs for agents. Prefer punycode host. Account required to create links.

xn--3ds443g.xn--s7y/duan-online MCP Server

This MCP server provides “Short links + QR for agents,” exposing 5 live MCP tools. It supports batch operations with a maximum size of 100, and it is designed to work with a punycode host preference.

🛠️ Key Features

Short links generation for agent use
QR support for the generated links
5 live MCP tools exposed by the server
Batch processing with batch size limited to ≤100
Prefer punycode host

🚀 Use Cases

Agent workflows that require short links
Generating QR codes alongside shortened links
Bulk creation of links in batches up to 100 items

⚡ Developer Benefits

Fixed set of 5 live tools for integration
Batch support with a defined upper bound (≤100)
Host handling guidance: prefer punycode

Captured live from the server via tools/list.

shorten_url

Create one short link. Returns state, URLs when active, qr_tracking_url. Tool call requires a registered account (Bearer or OAuth).

Parameters5

url	string	required	Destination HTTPS/HTTP URL to shorten. Required. Do not send longUrl.
alias	string	optional	Optional custom path segment (stored lowercase). Do not send customSlug.
title	string	optional
locale	string	optional
idempotency_key	string	required	Client-generated unique key for this create. Required. Replays within 24h.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Destination HTTPS/HTTP URL to shorten. Required. Do not send longUrl."
    },
    "alias": {
      "description": "Optional custom path segment (stored lowercase). Do not send customSlug.",
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "title": {
      "type": "string",
      "maxLength": 256
    },
    "locale": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Client-generated unique key for this create. Required. Replays within 24h."
    }
  },
  "required": [
    "url",
    "idempotency_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

shorten_urls

Create up to 100 short links in one sync batch. Correlate with client_ref. Tool call requires a registered account (Bearer or OAuth).

Parameters2

items	array	required
idempotency_key	string	required	Client-generated unique key for this create. Required. Replays within 24h.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "client_ref": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Batch item correlation id (never use array index)."
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "description": "Destination HTTPS/HTTP URL to shorten. Required. Do not send longUrl."
          },
          "alias": {
            "description": "Optional custom path segment (stored lowercase). Do not send customSlug.",
            "type": "string",
            "minLength": 1,
            "maxLength": 32
          },
          "title": {
            "type": "string",
            "maxLength": 256
          },
          "locale": {
            "type": "string"
          }
        },
        "required": [
          "client_ref",
          "url"
        ]
      }
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Client-generated unique key for this create. Required. Replays within 24h."
    }
  },
  "required": [
    "items",
    "idempotency_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_link

Fetch one link by id (owner-scoped when authenticated). Tool call requires a registered account (Bearer or OAuth).

Parameters1

string

required

Short code / link id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Short code / link id"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

resolve_short_url

Resolve a short URL or code to status; destination only if active. Tool call requires a registered account (Bearer or OAuth).

Parameters2

url	string	optional	Full short URL (Unicode or punycode)
code	string	optional	Short code if URL not provided

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "description": "Full short URL (Unicode or punycode)",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "code": {
      "description": "Short code if URL not provided",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_qr

Owner-only: return qr_tracking_url, PNG image content, and resource links to GET /v1/links/{id}/qr (PNG+SVG). Tool call requires a registered account (Bearer or OAuth).

Parameters5

id	string	optional	Short code of a link you own
short_url	string	optional	Owned short URL (Unicode or punycode)
short_url_ascii	string	optional	Owned short URL in punycode form
format	string	optional	Preferred image format (PNG always embedded; SVG via resource link)
size	any	optional	PNG pixel size: 256, 512 (default), or 1024

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Short code of a link you own",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "short_url": {
      "description": "Owned short URL (Unicode or punycode)",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "short_url_ascii": {
      "description": "Owned short URL in punycode form",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "format": {
      "description": "Preferred image format (PNG always embedded; SVG via resource link)",
      "type": "string",
      "enum": [
        "png",
        "svg"
      ]
    },
    "size": {
      "description": "PNG pixel size: 256, 512 (default), or 1024",
      "anyOf": [
        {
          "type": "number",
          "const": 256
        },
        {
          "type": "number",
          "const": 512
        },
        {
          "type": "number",
          "const": 1024
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_links

List short links owned by the authenticated account (paginated). Tool call requires a registered account (Bearer or OAuth).

Parameters2

cursor	string	optional	Pagination cursor from previous next_cursor
limit	integer	optional	Page size (1–100, default 50)

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Pagination cursor from previous next_cursor",
      "type": "string"
    },
    "limit": {
      "description": "Page size (1–100, default 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_link_analytics

Human-adjusted click analytics for a link you own (countries, devices, referrers, QR-tagged visits). Tool call requires a registered account (Bearer or OAuth).

Parameters5

id	string	required	Short code / link id you own
from	string	optional	Window start ISO8601 UTC (default last 7 days)
to	string	optional	Window end ISO8601 UTC
include	string	optional	Set all_traffic to add all_clicks
granularity	string	optional	Set day to include daily series

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Short code / link id you own"
    },
    "from": {
      "description": "Window start ISO8601 UTC (default last 7 days)",
      "type": "string"
    },
    "to": {
      "description": "Window end ISO8601 UTC",
      "type": "string"
    },
    "include": {
      "description": "Set all_traffic to add all_clicks",
      "type": "string"
    },
    "granularity": {
      "description": "Set day to include daily series",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_link

Update a link you own (destination). Tool call requires a registered account (Bearer or OAuth).

Parameters3

id	string	required	Short code / link id you own
title	string	optional
destination	string	optional	New destination URL

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Short code / link id you own"
    },
    "title": {
      "type": "string",
      "maxLength": 256
    },
    "destination": {
      "description": "New destination URL",
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

disable_link

Disable a link you own (destination withheld until re-enabled). Tool call requires a registered account (Bearer or OAuth).

Parameters1

string

required

Short code / link id you own

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Short code / link id you own"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Install

Tools (9)

shorten_urlshorten_urlsget_linkresolve_short_urlcreate_qrget_linksget_link_analyticsupdate_link

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://xn--s7y.xn--3ds443g/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "duan-online": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xn--s7y.xn--3ds443g/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xn--3ds443g.xn--s7y/duan-online MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

shorten_url

shorten_urls

get_link

resolve_short_url

create_qr

get_links

get_link_analytics

update_link

disable_link

Install

Remote endpoint

Related servers