# mcp-shorturl

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add acedatacloud-mcp/mcp-shorturl

# Browse available tools
npx -y @smithery/cli@latest tool list acedatacloud-mcp/mcp-shorturl

# Get full schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-shorturl shorturl_get_usage_guide

# Call a tool
npx -y @smithery/cli@latest tool call acedatacloud-mcp/mcp-shorturl shorturl_get_usage_guide '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-shorturl--acedatacloud-mcp.run.tools`

**Required config:**
- `x-api-key` (header) — AceDataCloud API Bearer Token (get from https://platform.acedata.cloud)

## Tools (4)

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

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-shorturl <tool-name>
```

## Prompts (3)

- `shorturl_guide` — Guide for choosing the right ShortURL tool for URL shortening tasks.
- `shorturl_workflow_examples` — Common workflow examples for ShortURL tasks.
- `shorturl_best_practices` — Best practices for URL shortening.