Summary
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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Public tool metadata for what this MCP can expose to an agent.
8 tools
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
androidUrlstringAndroid-specific redirect URL (for deep linking to Android apps).
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
customSlugstringCustom slug for a branded short link, e.g. 'my-brand'. Must be 2-50 chars, alphanumeric with dashes/underscores.
expiresAtstringExpiry date in ISO-8601 format, e.g. '2026-12-31T23:59:59'. Link auto-expires after this time.
iosUrlstringiOS-specific redirect URL (for deep linking to iOS apps).
longUrlstringThe long URL to shorten (required, must be a valid accessible URL)
maxClicksintegerMaximum click count. Link auto-deactivates after this many clicks.
passwordstringPassword 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
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystringThe 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
apikeystringYour 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
androidUrlstringNew Android-specific redirect URL.
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
iosUrlstringNew iOS-specific redirect URL.
isActivebooleanSet to true to activate or false to deactivate the link.
longUrlstringNew destination URL. Will be validated for safety.
urlKeystringThe 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
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystringThe 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
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlstringThe 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
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
urlKeystringThe 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
apikeystringYour API key for authentication. Not required if the server has a configured MCP_API_KEY.
sizeintegerQR code image size in pixels (default: 300, min: 50, max: 1000).
urlKeystringThe short code (urlKey) of the link to generate a QR code for
URL Shortener API
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
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
utility_shorten_url | POST | /api/shorten | $0.003 | Shorten a URL and return the shortened version |
utility_shorten_url
Use this when you need to shorten a long URL into a compact link. Accepts any valid URL and returns a shortened URL with the hash code, original URL, and creation timestamp. Do NOT use for domain intelligence — use domain_lookup_intelligence instead. Do NOT use for web scraping — use web_scrape_to_markdown instead. Do NOT use for SEO analysis — use seo_audit_page instead.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | string | yes | The URL to shorten |
custom_alias | string | no | Optional custom alias for the short URL (3-20 alphanumeric chars) |
Example agent prompts
- "Shorten a long URL into a compact link"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →