Skip to content
MCP server

esyURL

Create short links and styled QR codes whose destinations you can change after printing

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
0.2.0
Listing updated
1 day ago

About esyURL

esyURL is a freemium MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

esyURL is a link shortener first opened in 2007 and reworked so an AI agent can run it. The agent shortens a URL, renders a styled QR code, edits where a printed link points without breaking the code, and reads visit stats split into QR scans, direct clicks and bots. Redirect rules can send visitors by device, OS, browser, language, country, referrer or time, so one poster QR can open the App Store for iPhones and Google Play for Android.

Two features stand out. An agent can sign itself up with no human: it follows the auth.md flow to get an API key, starting with 100 links and rising to 1,000 once a person claims the account by email. And paid extras are settled by the agent over x402 in USDC: a custom domain is 5 USDC once, and a single styled QR code without an account costs 0.01 USDC.

Short links can also display a link-in-bio style page of buttons. The hosted server is not open source; the repository's MIT licence covers only its documentation.

Install

Run in a terminal

claude mcp add --transport http mcp https://esyurl.fyi/mcp

Add to Settings → Connectors → Add custom connector

https://esyurl.fyi/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://esyurl.fyi/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://esyurl.fyi/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://esyurl.fyi/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://esyurl.fyi/mcp"
    }
  }
}

Tools this server provides (19)

Taken from the project documentation; the running server may differ.

create_short_link
Shorten a URL with optional slug, QR style and redirect rules
list_short_links
List links by tag or group
get_short_link
One link with groups and visit count
update_short_link
Change destination, QR style or rules, or pause
delete_short_link
Delete a link
test_redirect_rules
Check which destination a visitor would get
get_short_link_visits
Visits per day by scans, clicks and bots
render_qr_code
PNG QR code with styling
create_group
Create a link group
list_groups
List groups
get_group
Get one group
update_group
Update a group
delete_group
Delete a group
add_links_to_group
Add links to a group
remove_link_from_group
Remove a link from a group
get_group_visits
Combined visits for a group
get_custom_domain
Show the custom domain
set_custom_domain
Set a custom domain
remove_custom_domain
Remove the custom domain

What it does

Editable destinations
Change where a printed link or QR code points.
Redirect rules
Route by device, OS, language, country, referrer or time.
Styled QR codes
Custom shapes, colours, logo or photo background.
Visit statistics
Per-day visits split into scans, clicks and bots.
Custom domains
Use your own domain with managed HTTPS.
Agent self-signup
Agents get a key without a human account.
Link pages
Show a page of buttons instead of redirecting.

Good for

  • Printing one QR code that routes iPhone and Android users differently
  • Updating a printed code's destination later
  • Branding links with your own domain
  • Tracking how many visitors scanned versus clicked

Pricing

Freemium

Links, QR codes and stats free; custom domain 5 USDC once; styled QR without account 0.01 USDC

Prices change. Check esyurl.fyi before you buy.

esyURL FAQ

Is it free?

Links, QR codes and stats are free; a custom domain costs 5 USDC once.

How does an agent get a key?

By following esyurl.fyi/auth.md to create an anonymous identity and swap it for a key.

What are the link limits?

100 links for self-signed-up accounts, 1,000 after a human claims it.

Is the server open source?

No. The repository's MIT licence covers its documentation only.

Is esyURL free?

esyURL has a free plan, with paid plans for more usage or features.

How do I add esyURL to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://esyurl.fyi/mcp

What are the best alternatives to esyURL?

The closest alternatives to esyURL are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to esyURL

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools