# MiniURL MCP Server

Endpoint: https://workers.miniurl.com/mcp

MiniURL provides a remote Model Context Protocol server for agent clients that support Streamable HTTP and JSON-RPC tool calls.

## Preferred Flow

1. Call shorten_url first when no credentials are available. MiniURL can open a guest session automatically.
2. Call check_alias before creating a registered-user link with a custom alias.
3. Call authenticate_token when the user already has a gt_ guest token or mk_ API key.
4. Call send_registration_code and verify_registration_code to convert a guest session into a permanent account.
5. Use registered tools for list_links, get_link, update_link, delete_link, bulk_create_links, list_domains, get_link_stats, and tags.

## CLI Setup

```bash
codex mcp add miniurl --url https://workers.miniurl.com/mcp
claude mcp add --transport http miniurl https://workers.miniurl.com/mcp
gemini mcp add --transport http miniurl https://workers.miniurl.com/mcp
```

## Core Tools

- shorten_url
- check_alias
- create_guest_token
- authenticate_token
- clear_authentication
- send_registration_code
- verify_registration_code
- get_account_status
- list_links
- get_link
- update_link
- delete_link
- bulk_create_links
- list_domains
- get_link_stats
- start_pro_upgrade
- list_tags
- create_tag
- delete_tag
- tag_link
- untag_link

## REST Fallback

When MCP is not available, use the REST API at https://workers.miniurl.com/api/v1 and the OpenAPI spec at https://miniurl.com/openapi.json.