Claude MarketplacesSubmit
br0ski777 avatar

URL Shortener API

br0ski777/url-shortener-x402

This is a URL shortening service that generates hash-based short codes or lets you create custom aliases, backed by x402 micropayments. The server connects via SSE to a hosted API at url-shortener.api.klymax402.com, so you're calling a remote service rather than running something local. The GitHub repo is pretty bare, just TypeScript source without much documentation visible. You'd reach for this if you need programmatic URL shortening with payment integration built in, though the details on how x402 micropayments actually work or what they cost aren't clear from the available source. It's a straightforward shortener with an economic layer on top.

tools
8
transport
SSE
last updated
May 16, 2026
View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

shorten_urlShorten a long URL into a clean, short link. Supports optional custom slugs, password protection, expiry dates, click limits, and Android/iOS deep linking. The URL is validated for safety before shortening.8 params

Shorten a long URL into a clean, short link. Supports optional custom slugs, password protection, expiry dates, click limits, and Android/iOS deep linking. The URL is validated for safety before shortening.

Parameters* required
androidUrlstring
Android-specific redirect URL (for deep linking to Android apps).
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
customSlugstring
Custom slug for a branded short link, e.g. 'my-brand'. Must be 2-50 chars, alphanumeric with dashes/underscores.
expiresAtstring
Expiry date in ISO-8601 format, e.g. '2026-12-31T23:59:59'. Link auto-expires after this time.
iosUrlstring
iOS-specific redirect URL (for deep linking to iOS apps).
longUrlstring
The long URL to shorten (required, must be a valid accessible URL)
maxClicksinteger
Maximum click count. Link auto-deactivates after this many clicks.
passwordstring
Password to protect the link. Users must enter this to access the destination.
get_link_detailsGet full details of a previously shortened link by its short code (urlKey). Returns the destination URL, creation date, preview metadata, status, and all settings.2 params

Get full details of a previously shortened link by its short code (urlKey). Returns the destination URL, creation date, preview metadata, status, and all settings.

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystring
The short code (urlKey) of the link, e.g. 'abc123' or 'my-brand'
list_all_linksList all short links created with your API key. Returns an array of links with their details.1 params

List all short links created with your API key. Returns an array of links with their details.

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
update_linkUpdate a short link's destination URL, active status, or device routing (Android/iOS URLs). You can only update links you created.6 params

Update a short link's destination URL, active status, or device routing (Android/iOS URLs). You can only update links you created.

Parameters* required
androidUrlstring
New Android-specific redirect URL.
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
iosUrlstring
New iOS-specific redirect URL.
isActiveboolean
Set to true to activate or false to deactivate the link.
longUrlstring
New destination URL. Will be validated for safety.
urlKeystring
The short code (urlKey) of the link to update
delete_linkPermanently delete a short link. This action cannot be undone. You can only delete links you created.2 params

Permanently delete a short link. This action cannot be undone. You can only delete links you created.

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystring
The short code (urlKey) of the link to delete
preview_and_verify_urlScan a URL for safety threats, extract page metadata (title, description, image, favicon), check SSL certificate, follow redirects, and detect shortened URLs. Use BEFORE sharing or clicking any unknown link. Returns safety verdict from Google Safe Browsing, domain blacklist st...2 params

Scan a URL for safety threats, extract page metadata (title, description, image, favicon), check SSL certificate, follow redirects, and detect shortened URLs. Use BEFORE sharing or clicking any unknown link. Returns safety verdict from Google Safe Browsing, domain blacklist st...

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlstring
The URL to scan and analyze (required). Supports HTTP and HTTPS. If no protocol is specified, HTTPS is assumed. Examples: 'https://stripe.com', 'bit.ly/3xPromo'
get_link_analyticsGet click analytics for a short link. Returns total clicks, unique visitors, country breakdown, device breakdown, browser breakdown, and recent click activity with timestamps, locations, and referrers. Use to check if a shared link was clicked.2 params

Get click analytics for a short link. Returns total clicks, unique visitors, country breakdown, device breakdown, browser breakdown, and recent click activity with timestamps, locations, and referrers. Use to check if a shared link was clicked.

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystring
The short code (urlKey) of the link to get analytics for
generate_qr_code_urlGet the URL to download a QR code image (PNG) for a short link. The returned URL can be embedded in documents, emails, or web pages. Use when you need a scannable QR code for a previously created short link.3 params

Get the URL to download a QR code image (PNG) for a short link. The returned URL can be embedded in documents, emails, or web pages. Use when you need a scannable QR code for a previously created short link.

Parameters* required
apikeystring
Your API key for authentication. Not required if the server has a configured MCP_API_KEY.
sizeinteger
QR code image size in pixels (default: 300, min: 50, max: 1000).
urlKeystring
The short code (urlKey) of the link to generate a QR code for

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

URL Shortener API

MCP Server x402 License: MIT

Shorten URLs using hash-based approach. Returns a compact shortened URL. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "url-shortener": {
      "url": "https://url-shortener.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl -X POST "https://url-shortener.api.klymax402.com/api/shorten" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

View the full README on GitHub

Details

Repository
github.com/br0ski777/url-shortener-x402
Website
github.com/Br0ski777/url-shortener-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777