short-url

name	short-url
description	Create short URLs via AceDataCloud API. Use when generating shortened links for sharing, or batch-creating multiple short URLs at once. Supports custom slugs and expiration.
license	Apache-2.0
metadata	{"author":"acedatacloud","version":"1.0"}
compatibility	Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-short-url for tool-use.

Short URL Service

Create short URLs through AceDataCloud's URL shortening API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

Quick Start

curl -X POST https://api.acedata.cloud/short-url \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/very-long-url-path?with=params"}'

Workflows

1. Create a Single Short URL

POST /short-url
{
  "url": "https://example.com/article/2024/awesome-content",
  "expires_in": 86400
}

Response:

{
  "short_url": "https://acda.cc/abc123",
  "url": "https://example.com/article/2024/awesome-content"
}

2. Batch Create Short URLs

Create multiple short URLs in one request.

POST /short-url/batch
{
  "urls": [
    "https://example.com/page1",
    "https://example.com/page2",
    "https://example.com/page3"
  ]
}

Parameters

Single

Parameter	Required	Description
url	Yes	The original long URL to shorten
expires_in	No	Expiration in seconds (omit for permanent)

Batch

Parameter	Required	Description
urls	Yes	Array of URLs to shorten

MCP Server

pip install mcp-short-url

Or hosted: https://short-url.mcp.acedata.cloud/mcp

Key tools: create_short_url, batch_create_short_urls

Gotchas

• Short URLs use the acda.cc domain
• Results are returned synchronously — no task polling needed
• Batch endpoint accepts an array and returns an array in the same order
• If expires_in is omitted, the short URL is permanent