# 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-create a short-lived guest bearer token when no auth is configured
- Production Agent behavior: discover OAuth 2.1 + PKCE from https://workers.miniurl.com/.well-known/oauth-protected-resource and https://workers.miniurl.com/.well-known/oauth-authorization-server, then use a short-lived scoped at_ token
- Safety controls: OAuth Agent tokens can preview create/update redirects with dry_run=true; destructive link/tag/domain/billing operations return human approval links by default
- Production MCP auth: there is no token-setting tool; use OAuth 2.1 + PKCE for a short-lived scoped at_ token, and never expose a long-lived mk_ key to an Agent model
- Raw Streamable HTTP: prefer stateless MCP 2026-07-28 with per-request _meta, MCP-Protocol-Version, Mcp-Method, and Mcp-Name for tools/call; legacy initialize/Mcp-Session-Id remains compatible
- OAuth client registration: Client ID Metadata Documents are supported; Dynamic Client Registration remains available as a fallback
- Agent discovery: the MCP server must be explicitly registered in the Agent runtime; visiting this website does not install it

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. For production Agent access, use OAuth 2.1 + PKCE to obtain a scoped at_ token. The guest registration endpoints remain a human account bootstrap flow; do not relay the returned mk_ key to a model
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 URL Shortener & QR Code Generator | MiniURL](https://miniurl.com/integrations/google-forms-short-link/): Shorten a Google Forms responder link, create a QR code, and track visits for hiring, event registration, surveys, classes, and feedback.
- [MCP URL Shortener for AI Agents | MiniURL](https://miniurl.com/integrations/mcp-url-shortener/): Connect AI agents to MiniURL's remote MCP server to create short links, check aliases, manage campaigns, and read click analytics.
- [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 URL Alias Shortener for Branded Links | MiniURL](https://miniurl.com/use-cases/custom-alias-url-shortener/): Create memorable custom URL aliases for campaigns, QR codes, and branded domains. Learn how to choose, test, and maintain a readable short link.
- [Event Registration QR Code Generator & Tracking | MiniURL](https://miniurl.com/use-cases/event-registration-qr-code/): Create an event registration QR code and short URL for posters, invitations, partners, and venues. Test every placement and measure interest.
- [Job Application QR Code Generator & Tracking | MiniURL](https://miniurl.com/use-cases/job-application-qr-code/): Create a job application QR code and short URL for hiring flyers, career fairs, storefronts, and job ads. Test the candidate journey.
- [Restaurant Menu QR Code Generator & Tracking | MiniURL](https://miniurl.com/use-cases/restaurant-menu-qr-code/): Create and test a restaurant menu QR code with a readable short URL. Learn practical menu, print, placement, and reporting checks.
- [Social Media Link Tracking with Short URLs | MiniURL](https://miniurl.com/use-cases/social-media-link-tracking/): Create trackable short links for social bios, posts, stories, creators, and campaigns. Compare placements without confusing clicks with conversions.
- [Tiny URL Generator for Short Links & QR Codes | MiniURL](https://miniurl.com/use-cases/tiny-link-generator/): Use a tiny URL generator to create short links, QR codes, readable aliases, and measurable campaigns without changing the destination page.
- [UTM Link Builder: Create Trackable Short URLs | MiniURL](https://miniurl.com/use-cases/utm-campaign-link-builder/): Build UTM campaign URLs, shorten them, and keep source reporting consistent across email, ads, social media, QR codes, and print.

## 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, 30-day link retention, 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