esyURL

io.github.esyurlv0.2.0更新於 Oct 7, 2026

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

已驗證Streamable HTTP可網頁執行Data & AnalyticsProductivity & Workflow

概覽

AI 產生的概覽

讓助理建立與管理短連結和樣式化 QR 碼、變更其導向目標，並讀取點擊與掃描統計。

功能
這是 esyURL 的託管 MCP 伺服器，用來縮短網址並產生樣式化 QR 碼。工具涵蓋建立、列出、更新、暫停與刪除短連結、測試導向規則，以及讀取拆分為 QR 掃描、直接點擊與機器人的造訪統計。連結可歸入群組，自訂網域可檢視、設定或移除。QR 碼可輸出為 PNG，支援自訂模組形狀、顏色與標誌。
適用情境
適合助理需要產生可分享的短連結或可列印的 QR 碼，且之後仍要控制其導向目標的情境，包括依裝置或國家分流。也適合追蹤掃描與點擊次數，或依群組與自訂網域管理連結。
執行需求
遠端 Streamable HTTP 端點，不需在本機安裝。需要 Authorization 標頭，值為 Bearer esy_ API 金鑰。README 表示助理可自行建立匿名帳號並取得金鑰，不需人工；之後可由人工以電子郵件認領帳號以提高連結上限。
安裝前請注意
Authorization 標頭帶有金鑰。連結可被更新、暫停或刪除，自訂網域可被新增或移除，會改變線上導向目標。設定自訂網域需依網域以 USDC 透過 x402 一次性付費，工具會先回傳付款要求。此伺服器為託管且非開源，連結與造訪資料會傳送給第三方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 esyURL，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

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:

sh
BASE=https://esyurl.fyiREG=$(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:

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

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

json
{  "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.

來源：README.md，提交 edf669a

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.2.0最新Oct 7, 2026