# MiniURL.com

> MiniURL.com is a URL shortener with analytics, custom aliases, QR codes, custom domains, and an agent-friendly REST API and MCP server.

## For AI Agents - Quick Start

If the client supports MCP, use the MiniURL MCP server first:

- MCP endpoint: https://workers.miniurl.com/mcp
- Transport: Streamable HTTP
- Preferred first tool: shorten_url
- Guest behavior: shorten_url can auto-open a guest session when no auth is configured
- Existing credentials: authenticate_token accepts gt_ or mk_ tokens
- Raw Streamable HTTP: read Mcp-Session-Id from initialize and send it on later MCP requests

If MCP is not available, use the REST API:

1. POST https://workers.miniurl.com/api/v1/guest/token
2. POST https://workers.miniurl.com/api/v1/shorten with Authorization: Bearer gt_xxxxx and body {"url":"https://example.com"}
3. Use /api/v1/guest/register and /api/v1/guest/verify to convert a guest flow into a registered mk_ API key
4. Use POST /api/v1/alias/check before custom aliases and GET /api/v1/tags for registered account tag workflows

Always read the meta object in API responses. It may include usage, notices, limitations, and upgrade hints.

## Agent-Readable Docs

- [REST API Markdown](https://miniurl.com/ai/apidocs.md)
- [MCP Markdown](https://miniurl.com/ai/mcp.md)
- [OpenAPI JSON](https://miniurl.com/openapi.json)
- [AI index](https://miniurl.com/ai/index.md)

## Main Pages

- [Home](https://miniurl.com/): Create short URLs, QR codes, and track clicks
- [Pricing](https://miniurl.com/pricing/): Compare Guest, Free, and Pro plans
- [REST API docs](https://miniurl.com/apidocs/): Endpoint reference and quick start
- [MCP docs](https://miniurl.com/mcp/): Agent tool reference and setup
- [Terms](https://miniurl.com/terms/)
- [Privacy](https://miniurl.com/privacy/)

## Marketing Hubs

- [MiniURL Comparisons](https://miniurl.com/compare/): Compare MiniURL with common link management approaches and short link workflows.
- [MiniURL Integrations](https://miniurl.com/integrations/): Short link workflows for forms, messaging, automation, and agent-friendly tools.
- [MiniURL Use Cases](https://miniurl.com/use-cases/): Practical ways to use short links, QR codes, analytics, and campaign tracking with MiniURL.

## Marketing Pages

- [TinyURL Alternative With QR Codes and Analytics - MiniURL](https://miniurl.com/compare/tinyurl-alternative/): Compare MiniURL as a TinyURL alternative for short links, custom aliases, QR codes, analytics, API access, and custom domains.
- [Google Forms Short Link Generator - MiniURL](https://miniurl.com/integrations/google-forms-short-link/): Create clean short links and QR codes for Google Forms. Track clicks for hiring, event registration, surveys, and feedback campaigns.
- [WhatsApp Short Link Generator - MiniURL](https://miniurl.com/integrations/whatsapp-short-link/): Shorten WhatsApp chat links for ads, profiles, support flows, and printed campaigns while keeping click tracking in MiniURL.
- [Custom Alias URL Shortener - MiniURL](https://miniurl.com/use-cases/custom-alias-url-shortener/): Create custom URL aliases for readable short links, branded campaigns, QR codes, custom domains, and click analytics.
- [Job Application QR Code Links - MiniURL](https://miniurl.com/use-cases/job-application-qr-code/): Create short links and QR codes for job applications, hiring flyers, recruiting events, and applicant tracking campaigns.
- [Restaurant Menu QR Code Links - MiniURL](https://miniurl.com/use-cases/restaurant-menu-qr-code/): Create a short link and QR code for restaurant menus, table tents, takeout flyers, and seasonal menu updates.
- [Tiny Link Generator With QR Codes and Analytics - MiniURL](https://miniurl.com/use-cases/tiny-link-generator/): Generate tiny links from long URLs, add QR codes and custom aliases, and track clicks for campaigns, profiles, print, and automation.
- [UTM Campaign Link Builder With Short URLs - MiniURL](https://miniurl.com/use-cases/utm-campaign-link-builder/): Build UTM-tagged campaign URLs, shorten them, and track clicks across email, ads, social posts, QR codes, and offline campaigns.

## Core Features

- URL shortening with auto-generated or custom aliases
- QR code generation
- Click analytics
- Custom domains
- Password protection, expiration, scheduled activation, and smart routing on Pro
- Bulk link creation, tags, domains, and link stats through API/MCP

## Pricing Snapshot

- Guest: 5 links per temporary token, token lasts 1 hour, links expire after 30 days
- Free: 50 links/month, custom aliases, 1 custom domain, basic analytics, 30 req/min API rate limit
- Pro: $5/month or $45/year, unlimited links, 1-3 custom domains, full analytics, password protection, custom expiration, scheduled activation, 120 req/min API rate limit