Easy your URL, rebuilt for AI agents

Short links your AI agent runs for you.

Ask for a link or a QR code. Your agent creates it on your own domain, sends every visitor to the right place, pays for what it needs and tells you who came.

/llms.txt

No dashboard, no forms: paste one prompt into Claude Code or any MCP client. Are you an agent? Start at /llms.txt and /auth.md.

An agent creating a short link with redirect rules and a QR code. The QR code opens this page.

Use with

  • Claude Code
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Cline
  • OpenCode
  • OpenClaw
  • and any MCP client

New in 2026

Three things a 2007 link shortener never did.

The same idea, made easy. Rebuilt for a time when agents type the links.

Redirect rules

One QR code. The right place for everyone.

Print one code on the poster. iPhones land in the App Store, Android in Google Play, Portuguese speakers on the Portuguese page and everyone else on the website. The first rule that matches wins.

  • Match on device, OS, browser, language, country, referrer, query, QR or direct, and time
  • Try any visitor first with POST /resolve: nothing is recorded
  • Visit stats show which rule sent each person where

Custom domains

Your brand on every link and QR code.

Bring go.yourbrand.com. Once it is active, every short link works there, and new short URLs and QR codes use it. HTTPS certificates are issued and renewed for you.

  • Your agent sets it up with PUT /v1/domain, then creates the DNS records it is given
  • Each status check moves it forward and says what to do next
  • One payment per new domain, made by your agent with x402

Self-service for agents

Your agent signs itself up and pays its own way.

No sign-up forms, no card on file. An agent gets its own API key by following auth.md. When something costs money, like a custom domain, the API answers HTTP 402 and the agent pays in USDC with x402.

  • Sign-up with no human in the loop, following the auth.md spec
  • One payment per new domain, taken only once the request is accepted
  • A human can claim the account by email later, which raises the link limit
  1. 1POST /agent/identity200An anonymous identity, no human needed
  2. 2POST /oauth2/tokenesy_…Swaps the assertion for an API key
  3. 3PUT /v1/domain402Payment required: 5.00 USDC on Base
  4. 4PUT /v1/domain + PAYMENT-SIGNATURE200Paid with x402: go.acme.com is on its way
  • 5 USDConce per new custom domain
  • 100 → 1,000links before and after a human claims the account
  • 0.01 USDCa styled QR code, without an account

QR code styles

QR codes in your style. Free on every link.

Dots or rounded rows, round corner markers, your colours, your logo in the middle, or a photo behind the code. Ask your agent for a style once, and every QR code of that link uses it.

  • Five module shapes and three corner-marker shapes, in any colours with enough contrast
  • A logo or a halftone photo: PNG, JPEG, WebP or GIF, kept with the link
  • Built to scan: corner markers stay solid, logos stay small, error correction goes up

Every example scans and opens this page. No account? An agent can buy a single styled code for 0.01 USDC with x402: POST /x402/qr.

Link pages

A link-in-bio page, on the same short link.

Instead of redirecting, a short link can show a page of buttons: your shop, your booking link, your socials. Your agent writes it and styles it, and the QR code you already printed opens it.

  • Seven themes, then your colours, fonts, button shapes, avatar and background
  • Buttons only some visitors see: the App Store on iPhones, the Portuguese menu for Portuguese speakers
  • Clicks counted per button. No scripts and no trackers on the page

Pages are free. Pages your agent makes after signing itself up carry a small esyURL footer; removing it costs 3 USDC, once per page, paid by your agent with x402.

And the essentials

Everything else your agent can do.

Everything is done by asking. A few things to ask for:

  • Memorable short links

    /menu, not a random jumble. Change the destination later and printed links keep working. Pause one any time.

  • QR codes

    PNG or SVG, any size, styled your way. Scans are counted apart from clicks, and bots apart from both.

  • Visit analytics

    Visits per day, split into QR scans, direct clicks and bots, and by which rule sent them where.

  • Groups

    Organise links by campaign, client or event, and see their visits together.

  • A code for anything

    A one-off QR code for any text: Wi-Fi details, a phone number, a contact card. Nothing saved or tracked.

  • MCP, REST and OpenAPI

    An MCP server, a plain REST API and an OpenAPI document. One key for all three.

Get started in one paste

Paste this into your agent. It does the rest.

Claude Code, or any agent that can read a web page and call an API.

No key yet

Your agent signs itself up and gets a key.

Recommended
Set up esyURL, my URL shortener and QR code service, and start using it.
Read https://esyurl.fyi/auth.md and follow it to get an API key.
Then add the MCP server: claude mcp add --transport http esyurl https://esyurl.fyi/mcp --header "Authorization: Bearer <API key>"
Read https://esyurl.fyi/llms.txt, confirm with GET /v1/me, and use esyURL whenever I ask for a short link or QR code.

I have a key

Replace esy_... with the key you were given.

Set up esyURL, my URL shortener and QR code service, and start using it. My API key is esy_...
Add the MCP server: claude mcp add --transport http esyurl https://esyurl.fyi/mcp --header "Authorization: Bearer esy_..."
Read https://esyurl.fyi/llms.txt, confirm with GET /v1/me, and use esyURL whenever I ask for a short link or QR code.

Another MCP client? Point it at https://esyurl.fyi/mcp (Streamable HTTP) with the header Authorization: Bearer esy_....

# Create a link
curl -s https://esyurl.fyi/v1/links \
  -H "Authorization: Bearer $ESYURL_KEY" \
  -H 'content-type: application/json' \
  -d '{"targetUrl":"https://example.com/spring-menu","slug":"menu"}'
# → {"shortUrl":"https://esyurl.fyi/menu", ...}

# Fetch its QR code
curl -s "https://esyurl.fyi/v1/links/$LINK_ID/qr?format=svg" \
  -H "Authorization: Bearer $ESYURL_KEY" -o menu.svg

Our story

Easy your URL, since 2007.

esyURL was created in 2007, in Brazil, by Filipe Boldo. It was born when Twitter gave a post only 140 characters and a long URL could use them all up. It made long URLs short and easy to share on Twitter, in emails, forums and blogs, with a Firefox toolbar, a Netvibes widget and an API for anyone who wanted to build on it. It was Filipe’s first app that people really used.

In 2026 it is back, rebuilt for a time when we hardly type links any more: our agents do. Same name, same idea. Make the URL easy.

  1. 2007Toolbar, Netvibes widget, file uploads and an API. Tens of thousands of esyURLs.
  2. 2026Reborn for agents: MCP, styled QR codes, link pages, redirect rules, custom domains, x402 payments and analytics.