English Français العربية

esyURL

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو esyURL؟

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

كيف أثبّت esyURL؟

يعمل كخادم بعيد. في 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>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج esyURL إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل esyURL مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون esyURL؟

ينشره esyurl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.