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 生成的概览

让助手创建和管理短链接与样式化二维码，修改其跳转目标，并读取点击与扫码统计。

功能
这是一个 esyURL 的托管 MCP 服务器，用于缩短网址并生成样式化二维码。工具涵盖创建、列出、更新、暂停和删除短链接，测试跳转规则，以及读取按二维码扫码、直接点击和机器人拆分的访问统计。链接可归入分组，自定义域名可查看、设置或移除。二维码可渲染为 PNG，支持自定义模块形状、颜色和标志。
适用场景
适合助手需要生成可分享的短链接或可打印二维码，并在之后继续控制其跳转目标的场景，包括按设备或国家路由。也适合统计扫码与点击量，或按分组和自定义域名管理链接。
运行要求
远程 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