Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through a standardized interface. With the ShortURL MCP Server provided by AceData Cloud, you can directly generate short links in AI clients like Claude Desktop, VS Code, Cursor, and more.

​
Feature Overview

The ShortURL MCP Server offers the following core features:
  • Single URL Shortening — Convert long URLs into short, easy-to-share links
  • Batch URL Shortening — Shorten multiple URLs at once (up to 10)
  • Usage Guide — Access complete usage instructions and best practices
  • API Information — View API service details and error code explanations

​
Prerequisites

Before use, you need to obtain an AceData Cloud API Token:
  1. Register or log in to the AceData Cloud Platform
  2. Go to the ShortURL API page
  3. Click “Acquire” to get your API Token (free quota granted on first application)

​
Installation and Configuration

pip install mcp-shorturl

​
Method 2: Source Installation

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
After installation, you can start the service using the mcp-shorturl command.

​
Using in Claude Desktop

Edit the Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
If using uvx (no need to pre-install packages): 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
Save the configuration and restart Claude Desktop to use ShortURL-related tools in conversations.

​
Using in VS Code / Cursor

Create .vscode/mcp.json in your project root directory: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
Or use uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

​
Available Tools

Tool NameDescription
shorturl_createShorten a single URL
shorturl_batch_createBatch shorten multiple URLs (up to 10)
shorturl_get_usage_guideGet the complete usage guide
shorturl_get_api_infoGet API service details

​
Usage Examples

After configuration, you can directly invoke these functions in AI clients using natural language, for example:
  • “Please shorten this link for me”
  • “Batch shorten these 5 URLs”
  • “Generate a short link for sharing”

​
More Information