URL Shortener API

io.github.Br0ski777Published by GitHub account Br0ski777v1.1.0Updated Oct 24, 2026

Shorten URLs with hash-based codes or custom aliases. x402 micropayment.

VerifiedSSEWeb executableProductivity & WorkflowFinance

Overview

AI-generated overview

Remote MCP endpoint that shortens long URLs into compact links, paid per call with USDC micropayments over x402.

What you can do
  • Shorten a URL and get back a compact short link with its hash code, the original URL and a creation timestamp
  • Optionally request a custom alias of 3 to 20 alphanumeric characters for the short link
When to use it
Useful when an assistant needs to turn a long link into a compact shareable URL, for example in messages or documents, and a pay-per-call service is acceptable.
Requirements
A remote MCP endpoint reached over SSE; no API key or signup. Payment requires an x402-capable client with a wallet holding USDC on Base L2 (eip155:8453), which handles the 402 challenge, signing and retry.
Before you install
Every call costs $0.003 in USDC on Base, so an assistant can spend real money; a wallet and signing capability are involved. Shortened links are created on a third-party service, and the submitted URL is sent to that provider.

Installation

In SourceWeft

  1. Open URL Shortener API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Br0ski777%2Furl-shortener/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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.):

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

Quickstart -- HTTP (x402)

bash
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

ToolMethodPathPriceDescription
utility_shorten_urlPOST/api/shorten$0.003Shorten 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

NameTypeRequiredDescription
urlstringyesThe URL to shorten
custom_aliasstringnoOptional 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.

License

MIT

Source: README.md at commit ddea6ed

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts