# Tinyurl — MCP server on mcp.ai
> Connect your Tinyurl account and use 2 tools for URL shortener straight from your AI agent. Connect with your own API key. TinyURL shortens lengthy URLs, generating concise links for easier sharing and managing, often used in social media and marketing campaigns.

By: mcp.ai · official
Page: https://mcp.ai/tinyurl

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_tinyurl?ms=1787293740000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/tinyurl/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/tinyurl/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/tinyurl/skill.md
Postman collection (v2.1): https://mcp.ai/tinyurl/postman.json

## Tools
- tinyurl_create_short_url(url: string, tags?: string[], alias?: string, domain?: string, expires_at?: string) — Creates a shortened URL using TinyURL's API. This action takes a long URL and returns a shortened version, with optional parameters for customization like domain, alias, tags, and expiration date.
- tinyurl_list_urls(page?: integer, type: string, limit?: integer) — Tool to retrieve a list of TinyURLs from your account. Use when you need to view available or archived shortened URLs. Supports pagination and filtering by URL type (available or archived).

## Example prompts
- "What can I do in Tinyurl?"
- "Show me a summary of my Tinyurl account"

## Links
Docs: https://mcp.ai/docs/mcps/tinyurl
Website: https://mcp.ai/mcps/tinyurl