AceDataCloud/MCPShortURL

A Model Context Protocol (MCP) server for URL shortening using Short URL API through the AceDataCloud API.
Create short, shareable URLs directly from Claude, VS Code, or any MCP-compatible client.
Features
- **URL Shortening** - Convert long URLs into short, shareable links
- **Batch Shortening** - Shorten multiple URLs at once (up to 10 per batch)
- **Free Service** - Zero credit consumption per request
- **Permanent Links** - Short URLs never expire
- **surl.id Domain** - Short URLs use the clean surl.id domain
- **Bearer Auth** - Secure API access with token authentication
Tool Reference
| Tool | Description |
|------|-------------|
| 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. |
Connect: hosted OAuth, API token, or local stdio
The hosted endpoint is https://shorturl.mcp.acedata.cloud/mcp. Choose one route for the MCP client:
| Route | When to use it | Credential setup |
|---|---|---|
| Hosted OAuth | The client supports remote MCP OAuth | Add only the URL, then sign in to AceDataCloud and approve access. No token needs to be pasted into client configuration. |
| Hosted API token | The client cannot finish OAuth, or you need an explicit integration credential | Send an AceDataCloud API token in the Authorization: Bearer … header. Keep it in a local secret store or environment variable. |
| Local stdio | The client runs a local MCP process | Install mcp-shorturl and pass ACEDATACLOUD_API_TOKEN to that process. It still calls the AceDataCloud API. |
The hosted service advertises OAuth metadata and Dynamic Client Registration (DCR). **DCR registers the client application; it is not an API key.** OAuth signs you in and the client sends the resulting Bearer token; it may reuse or create an API credential for the account. Browser sign-in still requires an AceDataCloud account. The hosted service can be metered: review current service documentation and displayed pricing before a real operation. Do not configure both an OAuth login and a fixed Authorization header for the same server.
Hosted OAuth examples
- **Claude and Claude Desktop chat:** Add a remote custom connector in Customize → Connectors → Add custom connector, enter https://shorturl.mcp.acedata.cloud/mcp, select sign-in, and choose **Register automatically** if Claude asks how to register its OAuth client. Complete consent. Claude Desktop's local claude_desktop_config.json is a separate setup. Claude connector guide.
- **Claude Code:** claude mcp add --transport http --scope user shorturl https://shorturl.mcp.acedata.cloud/mcp, then claude mcp login shorturl. Check /mcp. Claude Code MCP guide.
- **Cursor:** Add a remote server with only https://shorturl.mcp.acedata.cloud/mcp. For a project, merge the entry below into /.cursor/mcp.json; for personal use, use ~/.cursor/mcp.json. Cursor MCP guide.
- **VS Code / Copilot:** Run **MCP: Add Server**, select HTTP, enter https://shorturl.mcp.acedata.cloud/mcp, then finish the browser sign-in. New portable workspace configs use /.mcp.json; the VS Code-specific format below uses /.vscode/mcp.json or the user profile. Check **MCP: List Servers**. VS Code MCP setup.
- **Codex:** codex mcp add shorturl --url https://shorturl.mcp.acedata.cloud/mcp, then codex mcp login shorturl. Its user settings are in ~/.codex/config.toml. Official Codex MCP guide.
Cursor project config (OAuth):
VS Code-specific workspace config (OAuth):
Hosted API token
1. Open Ace Data Cloud → Applications. Sign in, or register an account first.