de en es ja ko ru zh

ShortURLMCP

Name: ShortURLMCP
Author: AceDataCloud

by AceDataCloud

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

ShortURLMCP

Ein Model Context Protocol (MCP)-Server zum Kürzen von URLs unter Verwendung der Short URL API über die AceDataCloud API.

Erstellen Sie kurze, teilbare URLs direkt aus Claude, VS Code oder einem beliebigen MCP-kompatiblen Client.

Funktionen

URL-Kürzung - Wandeln Sie lange URLs in kurze, teilbare Links um
Stapelverarbeitung - Kürzen Sie mehrere URLs gleichzeitig (bis zu 10 pro Stapel)
Kostenloser Dienst - Kein Guthabenverbrauch pro Anfrage
Dauerhafte Links - Kurze URLs laufen nie ab
surl.id Domain - Kurze URLs verwenden die saubere surl.id-Domain
Bearer Auth - Sicherer API-Zugriff mit Token-Authentifizierung

Related MCP server: lnkify

Tool-Referenz

Tool	Beschreibung
`shorturl_create`	Erstellt eine kurze URL aus einer langen URL.
`shorturl_batch_create`	Erstellt kurze URLs für mehrere lange URLs in einem einzigen Stapel.
`shorturl_get_usage_guide`	Ruft einen umfassenden Leitfaden zur Verwendung der ShortURL-Tools ab.
`shorturl_get_api_info`	Ruft Informationen über den ShortURL-API-Dienst ab.

Schnellstart

1. API-Token abrufen

Registrieren Sie sich auf der AceDataCloud-Plattform
Gehen Sie zur API-Dokumentationsseite
Klicken Sie auf "Acquire", um Ihr API-Token zu erhalten
Kopieren Sie das Token für die unten stehende Verwendung

2. Den gehosteten Server verwenden (Empfohlen)

AceDataCloud hostet einen verwalteten MCP-Server — keine lokale Installation erforderlich.

Endpunkt: https://shorturl.mcp.acedata.cloud/mcp

Alle Anfragen erfordern ein Bearer-Token. Verwenden Sie das API-Token aus Schritt 1.

Claude.ai

Verbinden Sie sich direkt auf Claude.ai mit OAuth — kein API-Token erforderlich:

Gehen Sie zu Claude.ai Einstellungen → Integrationen → Mehr hinzufügen
Geben Sie die Server-URL ein: https://shorturl.mcp.acedata.cloud/mcp
Schließen Sie den OAuth-Anmeldevorgang ab
Beginnen Sie mit der Verwendung der Tools in Ihrer Konversation

Claude Desktop

Fügen Sie dies Ihrer Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf

Fügen Sie dies Ihrer MCP-Konfiguration hinzu (.cursor/mcp.json oder .windsurf/mcp.json):

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code (Copilot)

Fügen Sie dies Ihrer VS Code MCP-Konfiguration hinzu (.vscode/mcp.json):

{
  "servers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Oder installieren Sie die Ace Data Cloud MCP-Erweiterung für VS Code, die alle 15 MCP-Server mit einer Ein-Klick-Einrichtung bündelt.

JetBrains IDEs

Gehen Sie zu Einstellungen → Tools → AI Assistant → Model Context Protocol (MCP)
Klicken Sie auf Hinzufügen → HTTP
Einfügen:

{
  "mcpServers": {
    "shorturl": {
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude Code

Claude Code unterstützt MCP-Server nativ:

claude mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp \
  -h "Authorization: Bearer YOUR_API_TOKEN"

Oder fügen Sie es der .mcp.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cline

Fügen Sie dies den MCP-Einstellungen von Cline hinzu (.cline/mcp_settings.json):

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Amazon Q Developer

Fügen Sie dies Ihrer MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Roo Code

Fügen Sie dies den Roo Code MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "shorturl": {
      "type": "streamable-http",
      "url": "https://shorturl.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Continue.dev

Fügen Sie dies der .continue/config.yaml hinzu:

mcpServers:
  - name: shorturl
    type: streamable-http
    url: https://shorturl.mcp.acedata.cloud/mcp
    headers:
      Authorization: "Bearer YOUR_API_TOKEN"

Zed

Fügen Sie dies den Einstellungen von Zed hinzu (~/.config/zed/settings.json):

{
  "language_models": {
    "mcp_servers": {
      "shorturl": {
        "url": "https://shorturl.mcp.acedata.cloud/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

cURL-Test

# Health check (no auth required)
curl https://shorturl.mcp.acedata.cloud/health

# MCP initialize
curl -X POST https://shorturl.mcp.acedata.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

3. Oder lokal ausführen (Alternative)

Wenn Sie den Server lieber auf Ihrem eigenen Rechner ausführen möchten:

# Install from PyPI
pip install mcp-shorturl
# or
uvx mcp-shorturl

# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"

# Run (stdio mode for Claude Desktop / local clients)
mcp-shorturl

# Run (HTTP mode for remote access)
mcp-shorturl --transport http --port 8000

Claude Desktop (Lokal)

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

Docker (Self-Hosting)

docker pull ghcr.io/acedatacloud/mcp-shorturl:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-shorturl:latest

Clients verbinden sich mit ihrem eigenen Bearer-Token — der Server extrahiert das Token aus dem Authorization-Header jeder Anfrage.

Verfügbare Tools

URL-Kürzungstools

Tool	Beschreibung
`shorturl_create`	Eine einzelne URL kürzen
`shorturl_batch_create`	Mehrere URLs gleichzeitig kürzen (max. 10)

Informationstools

Tool	Beschreibung
`shorturl_get_usage_guide`	Umfassenden Nutzungsleitfaden abrufen
`shorturl_get_api_info`	API-Details und Fehlercodes abrufen

Anwendungsbeispiele

Eine einzelne URL kürzen

User: Shorten this URL: https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9

Claude: I'll shorten that URL for you.
[Calls shorturl_create with url="https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9"]

Result: https://surl.id/1uHCs01xa5

Mehrere URLs stapelweise kürzen

User: Shorten these URLs for my social media posts:
- https://example.com/blog/very-long-article-title-about-ai
- https://example.com/products/new-release-2024

Claude: I'll shorten both URLs at once.
[Calls shorturl_batch_create with urls=[...]]

Links für Dokumentationen erstellen

User: I need clean short links for these reference URLs in my doc.

Claude: I'll create short links for all your references.
[Calls shorturl_batch_create with the list of URLs]

Antwortstruktur

Erfolgreiche Antwort

{
  "success": true,
  "data": {
    "url": "https://surl.id/1uHCs01xa5"
  }
}

Fehlerantwort

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Konfiguration

Umgebungsvariablen

Variable	Beschreibung	Standardwert
`ACEDATACLOUD_API_TOKEN`	API-Token von AceDataCloud	Erforderlich
`ACEDATACLOUD_API_BASE_URL`	API-Basis-URL	`https://api.acedata.cloud`
`ACEDATACLOUD_OAUTH_CLIENT_ID`	OAuth-Client-ID (gehosteter Modus)	—
`ACEDATACLOUD_PLATFORM_BASE_URL`	Plattform-Basis-URL	`https://platform.acedata.cloud`
`SHORTURL_REQUEST_TIMEOUT`	Anfrage-Timeout in Sekunden	`30`
`LOG_LEVEL`	Protokollierungsebene	`INFO`

Befehlszeilenoptionen

mcp-shorturl --help

Options:
  --version          Show version
  --transport        Transport mode: stdio (default) or http
  --port             Port for HTTP transport (default: 8000)

Entwicklung

Entwicklungsumgebung einrichten

# Clone repository
git clone https://github.com/AceDataCloud/ShortURLMCP.git
cd ShortURLMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

# Install with dev dependencies
pip install -e ".[dev,test]"

Tests ausführen

# Run unit tests
pytest

# Run with coverage
pytest --cov=core --cov=tools

# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration

Codequalität

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools

Erstellen & Veröffentlichen

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

Projektstruktur

ShortURLMCP/
├── core/                   # Core modules
│   ├── __init__.py
│   ├── client.py          # HTTP client for ShortURL API
│   ├── config.py          # Configuration management
│   ├── exceptions.py      # Custom exceptions
│   └── server.py          # MCP server initialization
├── tools/                  # MCP tool definitions
│   ├── __init__.py
│   ├── shorturl_tools.py  # URL shortening tools
│   └── info_tools.py      # Information tools
├── prompts/                # MCP prompt templates
│   └── __init__.py
├── tests/                  # Test suite
│   ├── conftest.py
│   ├── test_client.py
│   ├── test_config.py
│   └── test_integration.py
├── deploy/                 # Deployment configs
│   ├── run.sh
│   └── production/
│       ├── deployment.yaml
│       ├── ingress.yaml
│       └── service.yaml
├── .env.example           # Environment template
├── .gitignore
├── .ruff.toml             # Ruff linter configuration
├── CHANGELOG.md
├── Dockerfile             # Docker image for HTTP mode
├── docker-compose.yaml    # Docker Compose config
├── LICENSE
├── main.py                # Entry point
├── pyproject.toml         # Project configuration
└── README.md

API-Referenz

Dieser Server umschließt die AceDataCloud Short URL API:

Endpunkt: POST /shorturl
Eingabe: { "content": "https://long-url.example.com/..." }
Ausgabe: { "success": true, "data": { "url": "https://surl.id/..." } }
Preise: Kostenlos (0 Credits)
Authentifizierung: Bearer-Token

Vollständige API-Dokumentation: AceDataCloud-Plattform

Lizenz

MIT-Lizenz - siehe LICENSE für Details.

Available Tools

4 tools

shorturl_batch_createAInspect

Create short URLs for multiple long URLs in a single batch.

Shortens multiple URLs at once, returning a mapping of original URLs
to their shortened versions. Useful for bulk URL shortening tasks.

Args:
    urls: A list of long URLs to shorten (max 10 per batch).

Returns:
    JSON response containing the mapping of original to shortened URLs.

Example:
    shorturl_batch_create(urls=["https://example.com/long-url-1", "https://example.com/long-url-2"])

Inputs: urls (required). Returns: result

shorturl_createAInspect

Create a short URL from a long URL.

Converts a long URL into a short, easy-to-share URL using the ShortURL API.
The short URL redirects to the original long URL when visited.

This is useful for:
- Sharing links on social media with character limits
- Creating clean, memorable links for marketing
- Tracking link clicks and engagement
- Making long URLs more manageable in documents and messages

Args:
    url: The long URL to shorten. Must be a valid HTTP or HTTPS URL.

Returns:
    JSON response containing the shortened URL.

Example:
    shorturl_create(url="https://platform.acedata.cloud/documents/a2303356-6672-4eb8-9778-75f55c998fe9")

Inputs: url (required). Returns: result

shorturl_get_api_infoAInspect

Get information about the ShortURL API service.

Returns details about the API endpoint, pricing, and service capabilities.

Returns:
    API information and service details.

Inputs: no named parameters. Returns: result

shorturl_get_usage_guideAInspect

Get a comprehensive guide for using the ShortURL tools.

Provides detailed information on how to use the ShortURL tools
effectively, including parameters, examples, and best practices.

Returns:
    Complete usage guide for ShortURL tools.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A4.1/5.0

Scored 2026-05-31 21:30 across 4 tools

Disambiguation5/5

Each tool has a clear, distinct purpose: single create, batch create, API info, and usage guide. No overlap in functionality.

Naming Consistency5/5

All tool names follow a consistent 'shorturl_' prefix with verb_noun pattern (e.g., batch_create, get_api_info). Perfectly uniform.

Tool Count5/5

With 4 tools, the server is well-scoped for a URL shortening service. It covers the core operations (create, batch create) and supporting info tools.

Completeness4/5

Covers all essential creation and information needs. Minor gap: no delete or update functionality, but agents can manage by creating new short URLs.

Maintenance

ActivityActive

ResponsivenessLimited data

Resources

Related MCP Connectors

Put It OnlineA
online.putit
Publish AI-made web pages and share files as short links from any MCP client.
Cloud Storage Content Management Systems
101
https://putit.online/mcp
Simple Click Tracker
com.simpleclicktracker
Create, find, update and delete Simple Click Tracker short links from Claude or any MCP client.
App Automation
1
https://app.simpleclicktracker.com/api/v1/mcp
mcp-openai
io.github.AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
AI & Machine Learning Image & Video Processing
11
https://openai.mcp.acedata.cloud/mcp
inbioA
io.github.www-in-bio
Official in.bio MCP server: shorten URLs, styled QR codes, and click analytics. No API key needed.
Marketing Data Visualization
2
https://mcp.in.bio/mcp

Related MCP Servers

URL Shortener MCP
App Automation Developer Tools
Talismanic
A
license
B
quality
D
maintenance
Provides a simple tool to shorten URLs using the CleanURI API, designed to run as a FastMCP server that can be integrated with agent or tool-based systems.
Updated a year ago (2025-07-06 19:06 UTC)
1
4
Apache 2.0
lnkifyofficial
Developer Tools App Automation
lnkify
A
license
Not graded
quality
D
maintenance
MCP server that enables AI agents to manage Lnkify links, domains, API keys, and analytics. Allows creation and resolution of short links through natural language.
Updated 5 months ago (2026-06-29 15:56 UTC)
MIT
INBIO MCP Serverofficial
Marketing
getinbio
A
license
Not graded
quality
C
maintenance
Official MCP server for INBIO's URL shortener with click analytics and customizable QR codes. Enables link shortening, QR code generation, and link management with optional authentication for advanced features.
Updated 4 months ago (2026-07-23 16:20 UTC)
MIT
sinkto-mcp
Marketing
kelvin6365
F
license
Not graded
quality
D
maintenance
Free URL shortener with a hosted MCP server. Create, update, and bulk-create short links with custom aliases and QR codes, and read click analytics (countries, cities, devices, browsers, referrers, UTM) from Claude, Cursor, or any MCP client. Unlimited links on the free plan; read-only and write scopes are assigned per API key.
Updated 3 months ago (2026-08-29 13:34 UTC)
1
-

ShortURLMCP

Funktionen

Tool-Referenz

Schnellstart

1. API-Token abrufen

2. Den gehosteten Server verwenden (Empfohlen)

Claude.ai

Claude Desktop

Cursor / Windsurf

VS Code (Copilot)

JetBrains IDEs

Claude Code

Cline

Amazon Q Developer

Roo Code

Continue.dev

Zed

cURL-Test

3. Oder lokal ausführen (Alternative)

Claude Desktop (Lokal)

Docker (Self-Hosting)

Verfügbare Tools

URL-Kürzungstools

Informationstools

Anwendungsbeispiele

Eine einzelne URL kürzen

Mehrere URLs stapelweise kürzen

Links für Dokumentationen erstellen

Antwortstruktur

Erfolgreiche Antwort

Fehlerantwort

Konfiguration

Umgebungsvariablen

Befehlszeilenoptionen

Entwicklung

Entwicklungsumgebung einrichten

Tests ausführen

Codequalität

Erstellen & Veröffentlichen

Projektstruktur

API-Referenz

Lizenz

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

URL Shortener MCP

lnkifyofficial

INBIO MCP Serverofficial

sinkto-mcp