About URL Shortener x402
URL Shortener x402 is an MCP and HTTP API for AI agents that need compact links. It supports hash-based codes, optional custom aliases, and per-call USDC payments on Base without an API key or signup.
Key features
- 01Hash-based short URLs
- 02Optional custom aliases
- 03USDC payment per call
- 04HTTP API access
Use cases
- 01Shortening long links for agents
- 02Creating a link with a custom alias
MCP support
It exposes the `utility_shorten_url` tool to MCP clients, which accepts a URL and optional custom alias and returns a shortened link. The MCP endpoint is available over HTTP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://url-shortener.api.klymax402.com/mcpclaude mcp add --transport sse url-shortener-x402 https://url-shortener.api.klymax402.com/mcp{"mcpServers":{"url-shortener-x402":{"type":"sse","url":"https://url-shortener.api.klymax402.com/mcp"}}}Open in Cursor{"servers":{"url-shortener-x402":{"type":"sse","url":"https://url-shortener.api.klymax402.com/mcp"}}}Open in VS Code{"mcpServers":{"url-shortener-x402":{"type":"sse","url":"https://url-shortener.api.klymax402.com/mcp"}}}{"mcpServers":{"url-shortener-x402":{"serverUrl":"https://url-shortener.api.klymax402.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEURL 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.