English Français العربية

esyURL

Registre officiel Autres

Short links and trackable QR codes: editable after printing, device routing, scan stats.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http esyurl 'https://esyurl.fyi/mcp' --header 'Authorization: <Bearer esy_... API key. An agent can get one itself: https://esyurl.fyi/auth.md>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "esyurl": {
            "type": "http",
            "url": "https://esyurl.fyi/mcp",
            "headers": {
                "Authorization": "<Bearer esy_... API key. An agent can get one itself: https://esyurl.fyi/auth.md>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. esyURL MCP server
  2. Get an API key
  3. Connect
  4. Tools
  5. Pricing
  6. More
  7. License

esyURL MCP server

A hosted MCP server that lets AI agents create and manage short links and QR codes with esyURL: shorten URLs, render styled QR codes, change where a printed or shared link points, route visitors by device or country, and read click and scan stats. The agent can sign itself up; no human account is needed.

  • Endpoint: https://esyurl.fyi/mcp (Streamable HTTP, stateless)
  • Auth: Authorization: Bearer esy_...

There is nothing to install or run: this repository describes the hosted server. The server itself is not open source.

Get an API key

An agent without a key can create its own account and get one, following esyurl.fyi/auth.md:

BASE=https://esyurl.fyi
REG=$(curl -s $BASE/agent/identity -H 'content-type: application/json' -d '{"type":"anonymous"}')
KEY=$(curl -s $BASE/oauth2/token \
  --data-urlencode grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer \
  --data-urlencode assertion=$(echo "$REG" | jq -r .identity_assertion) | jq -r .access_token)
echo $KEY

Self-signed-up accounts get 100 links, 1000 once a human claims the account by email.

Connect

Claude Code:

claude mcp add --transport http esyurl https://esyurl.fyi/mcp \
  --header "Authorization: Bearer esy_..."

Cursor, VS Code and other clients (.mcp.json style):

{
  "mcpServers": {
    "esyurl": {
      "type": "http",
      "url": "https://esyurl.fyi/mcp",
      "headers": { "Authorization": "Bearer esy_..." }
    }
  }
}

Tools

ToolWhat it does
create_short_linkShorten a URL, with an optional custom slug, QR style and redirect rules
list_short_linksList your links, optionally by tag or group
get_short_linkOne link, with its groups and lifetime visit count
update_short_linkChange where a link points, its QR style or rules, or pause it; the short URL and printed QR codes keep working
delete_short_linkDelete a link
test_redirect_rulesCheck which destination a visitor would get (e.g. iPhone to the App Store, Android to Google Play)
get_short_link_visitsVisits per day, split into QR scans, direct clicks and bots
render_qr_codeA PNG QR code for a link (scans counted) or any text: module shapes, corner markers, colours, a logo or a photo
create_group, list_groups, get_group, update_group, delete_groupOrganise links into groups
add_links_to_group, remove_link_from_groupGroup membership
get_group_visitsCombined visits for a group
get_custom_domain, set_custom_domain, remove_custom_domainShort links on your own domain

Pricing

Links, QR codes and stats are free. Self-signed-up accounts pay once per new custom domain, in USDC with x402; set_custom_domain returns the payment requirements first.

More

License

MIT, for the contents of this repository.

Questions fréquentes

Qu'est-ce que esyURL ?

Short links and trackable QR codes: editable after printing, device routing, scan stats.

Comment installer esyURL ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http esyurl 'https://esyurl.fyi/mcp' --header 'Authorization: <Bearer esy_... API key. An agent can get one itself: https://esyurl.fyi/auth.md>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour esyURL ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

esyURL est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient esyURL ?

Il est publié par esyurl. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.