# esyURL

> esyURL is a freemium MCP server for marketing and seo. Create short links and styled QR codes whose destinations you can change after printing. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://esyurl.fyi
- **Repository:** https://github.com/esyurl/mcp
- **MCP Registry name:** io.github.esyurl/mcp
- **Categories:** marketing and SEO, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://esyurl.fyi/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://esyurl.fyi/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/esyurl
