# AceDataCloud/MCPShortURL [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/AceDataCloud/MCPShortURL  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/acedatacloud-mcpshorturl

## Description
Free URL shortening with batch support (up to 10 URLs), permanent surl.id short links, zero credit consumption.

## Tools
Capabilities this server exposes over MCP:

- **shorturl_create** — Create a short URL from a long URL.
- **shorturl_batch_create** — Create short URLs for multiple long URLs in a single batch.
- **shorturl_get_usage_guide** — Get a comprehensive guide for using the ShortURL tools.
- **shorturl_get_api_info** — Get information about the ShortURL API service.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcpshorturl": {
    "command": "uvx",
    "args": ["mcp-shorturl"],
    "env": {
      "ACEDATACLOUD_API_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `ACEDATACLOUD_API_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What AceDataCloud/MCPShortURL MCP server does

AceDataCloud/MCPShortURL MCP server connects MCP clients to AceDataCloud's Short URL API. It converts a supplied long URL into a shorter shareable URL, or processes a list of URLs in one request. Batch operations accept up to 10 URLs.

Created links use the `surl.id` domain and are described by the project as permanent, so they do not expire. The service is documented as consuming zero credits per request. This makes the server suitable for preparing concise links for documentation, messages, social posts, or other content generated with an AI client.

## How it works

The server exposes MCP tools that an attached client can call from a conversation or other MCP workflow. For a single link, the client calls `shorturl_create` with a long URL. For multiple links, it calls `shorturl_batch_create` with a URL list. A successful response contains the shortened URL under `data.url`; failures include an error code, message, and trace ID.

AceDataCloud hosts a managed MCP endpoint at `https://shorturl.mcp.acedata.cloud/mcp`. Requests to that endpoint use a Bearer token. Claude.ai is documented as a separate OAuth connection path, so it does not require entering the API token in that client’s integration flow.

## Setup and configuration

The hosted option requires an AceDataCloud account and API token. The README directs users to the Short URL API documentation to acquire the token, then configure the hosted endpoint and send it in an `Authorization: Bearer ...` header. Examples are provided for Claude Desktop, Cursor, Windsurf, Cline, and several other clients.

For local use, install the Python package from PyPI with `pip install mcp-shorturl` or run it with `uvx mcp-shorturl`. Set `ACEDATACLOUD_API_TOKEN` before starting the local process. Running `mcp-shorturl` starts stdio mode for local clients; `mcp-shorturl --transport http --port 8000` starts HTTP mode. The project also documents a Docker image for self-hosting.

## Tools and capabilities

- `shorturl_create`: creates one short URL from a long URL.
- `shorturl_batch_create`: creates short URLs for multiple URLs, with a maximum of 10 per batch.
- `shorturl_get_usage_guide`: returns guidance for using the ShortURL tools.
- `shorturl_get_api_info`: returns ShortURL API information and error details.
- Returns links on the `surl.id` domain.
- Provides permanent links according to the project documentation.

## Limitations and notes

AceDataCloud/MCPShortURL MCP server is specifically focused on URL shortening; the listed tools do not provide link analytics, custom aliases, editing, or deletion. Batch requests are limited to 10 URLs. The API requires token-based access for the hosted and local configurations, although the service states that requests consume zero credits. The README identifies the project as MIT-licensed and requires Python 3.10 or newer for the Python installation.

_Full upstream README: https://allmcps.com/mcp/acedatacloud-mcpshorturl/readme_