MCPShortURL

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.