esyURL

esyURL MCP 服务

一个托管的 MCP 服务，让 AI Agent 使用 esyURL 创建和管理短链接与二维码：缩短 URL、生成样式各异的二维码、更改印刷或分享出去的链接的指向、按设备或国家路由访客，以及查看点击和扫描统计。Agent 可以自行注册；无需人工账号。

• 端点：https://esyurl.fyi/mcp（Streamable HTTP，无状态）
• 身份验证：Authorization: Bearer esy_...

无需安装或运行任何东西：本仓库介绍的是托管服务。该服务本身不是开源的。

获取 API 密钥

没有密钥的 Agent 可以按照 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

自行注册的账号可创建 100 个链接；人工通过电子邮件认领账号后，可创建 1000 个链接。

连接

Claude Code：

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

Cursor、VS Code 和其他客户端（.mcp.json 样式）：

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

工具

工具	功能
create_short_link	缩短 URL，可选自定义别名、二维码样式和重定向规则
list_short_links	列出你的链接，可按标签或分组筛选
get_short_link	获取单个链接及其分组和生命周期访问次数
update_short_link	更改链接指向、二维码样式或规则，也可暂停链接；短 URL 和已印刷的二维码仍可使用
delete_short_link	删除链接
test_redirect_rules	检查访客会被导向哪个目标（例如，将 iPhone 用户导向 App Store，将 Android 用户导向 Google Play）
get_short_link_visits	按天统计访问量，并区分二维码扫描、直接点击和机器人
render_qr_code	为链接（会统计扫描次数）或任意文本生成 PNG 二维码；可设置模块形状、角标、颜色、徽标或照片
create_group、list_groups、get_group、update_group、delete_group	将链接整理到分组中
add_links_to_group、remove_link_from_group	管理分组成员
get_group_visits	查看分组的合并访问量
get_custom_domain、set_custom_domain、remove_custom_domain	在你自己的域名上创建短链接

定价

链接、二维码和统计数据均免费。自行注册的账号添加每个新自定义域名时需支付一次费用，以 USDC 通过 x402 支付；set_custom_domain 会先返回付款要求。

更多信息

• esyurl.fyi/llms.txt：面向 Agent 的 API
• esyurl.fyi/openapi.json：REST API
• esyurl/skills：同一套内容，以 Agent 技能形式提供 （npx skills add esyurl/skills）

许可证

MIT，适用于本仓库的内容。