MCP server

MiniURL

io.github.addychang/miniurl

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

23

Token cost

About 3,769 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http miniurl https://workers.miniurl.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.miniurl]
url = "https://workers.miniurl.com/mcp"

Gemini CLI

{"mcpServers":{"miniurl":{"httpUrl":"https://workers.miniurl.com/mcp"}}}

Cursor

{"mcpServers":{"miniurl":{"url":"https://workers.miniurl.com/mcp"}}}

VS Code

{"servers":{"miniurl":{"type":"http","url":"https://workers.miniurl.com/mcp"}}}

Antigravity

agy mcp add miniurl https://workers.miniurl.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"miniurl","server_url":"https://workers.miniurl.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"miniurl","server_url":"https://workers.miniurl.com/mcp"}

Tools

• add_domain ~168 tokens
  Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
• bulk_create_links ~211 tokens
  Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
• check_alias ~121 tokens
  Check whether a custom alias is available on a given domain before creating a link.
• clear_authentication ~79 tokens
  Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
• create_guest_token ~94 tokens
  Create a short-lived MiniURL guest bearer token. Legacy MCP sessions retain it; stateless clients must pass the returned gt_ token explicitly on later requests. shorten_url can provision one automatically.
• create_tag ~140 tokens
  Create a new tag for organising links. Maximum 20 tags per account.
• delete_domain Deletes data · ~157 tokens
  Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
• delete_link Deletes data · ~256 tokens
  Delete a registered short link permanently.
• delete_tag Deletes data · ~150 tokens
  Delete a tag and remove it from all associated links.
• get_account_status ~62 tokens
  Inspect the current guest/free/pro account status, remaining quota, and feature availability.
• get_link ~116 tokens
  Get a single short link by alias for the current registered account.
• get_link_stats ~170 tokens
  Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
• list_domains ~69 tokens
  List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
• list_links ~199 tokens
  List short links for the current registered account.
• list_tags ~63 tokens
  List all tags for the current registered account. Tags help organise links into campaigns or categories.
• send_registration_code Sends messages · ~90 tokens
  Send a 6-digit registration code to the user email, using the current guest session.
• shorten_url ~461 tokens
  Create a MiniURL short link for a supplied HTTP or HTTPS destination. Use when the user asks to shorten a URL or generate a MiniURL link. This is an additive external write; do not fetch or open the destination. If no authentication is supplied, MiniURL automatically starts a guest flow. Reuse idemp
• start_pro_upgrade ~194 tokens
  Create a shortened checkout link for upgrading the current registered account to Pro.
• tag_link ~139 tokens
  Add a tag to a short link for campaign or category organisation.
• untag_link ~128 tokens
  Remove a tag from a short link.
• update_link ~380 tokens
  Update a registered short link. Some fields require Pro.
• verify_domain ~184 tokens
  Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
• verify_registration_code ~138 tokens
  Verify the emailed code, create the account, claim guest links, and continue with OAuth 2.1 + PKCE. Long-lived API keys are never returned over MCP.

Browse

• GitHub tools
• Domains and DNS
• Email
• Email marketing
• GitHub and code hosting

Related MCP servers

• nittim
  Production-safety audits for AI-generated code, with a fix for every finding.
• Cooper Email
  Email inboxes for AI agents: send, receive, search, drafts with owner approval, and webhooks.
• StackFast FractWin Expert Brain
  Expert knowledge base for sales, negotiation, strategy, operations, and risk.
• Apologetics Wiki
  Bible verses, cross-references, Greek and Hebrew word studies, and Christian apologetics articles.
• Partle
  Search products in nearby stores. Agents can also list items for sale on a user's behalf.
• Gluecron
  AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
• Sulvo Audit
  Publisher revenue audit: ads.txt and ad-stack checks, Sulvo onboarding, and Boost ad-block recovery
• Vendooly
  Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.addychang/miniurl.svg)](https://aptlynx.net/servers/io.github.addychang/miniurl)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents