esyURL

esyURL MCP サーバー

AI エージェントが esyURL で短縮リンクや QR コードを作成・管理できる、ホスト型の MCP サーバーです。URL の短縮、スタイル付き QR コードの生成、印刷済みまたは共有済みのリンクの転送先変更、デバイスや国に応じた訪問者の振り分け、クリック数やスキャン数の統計の確認ができます。エージェント自身で登録できるため、人間のアカウントは必要ありません。

• エンドポイント：https://esyurl.fyi/mcp（Streamable HTTP、ステートレス）
• 認証：Authorization: Bearer esy_...

インストールや実行は不要です。このリポジトリではホスト型サーバーについて説明しています。サーバー自体はオープンソースではありません。

API キーを取得する

キーを持っていないエージェントは、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 を短縮します。カスタムスラッグ、QR スタイル、リダイレクトルールを任意で指定できます
list_short_links	リンクを一覧表示します。タグまたはグループで絞り込むこともできます
get_short_link	1 件のリンクと、そのグループおよび累計訪問数を取得します
update_short_link	リンクの転送先、QR スタイル、ルールを変更するか、リンクを一時停止します。短縮 URL と印刷済み QR コードは引き続き使用できます
delete_short_link	リンクを削除します
test_redirect_rules	訪問者がどの転送先に案内されるかを確認します（例：iPhone なら App Store、Android なら Google Play）
get_short_link_visits	1 日ごとの訪問数を、QR スキャン、直接クリック、ボットに分けて表示します
render_qr_code	リンク用（スキャン数は集計されます）または任意のテキスト用の PNG QR コードを生成します。モジュール形状、コーナーマーカー、色、ロゴ、写真を指定できます
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	独自ドメインで短縮リンクを使用します

料金

リンク、QR コード、統計は無料です。自分で登録したアカウントでは、新しいカスタムドメインごとに一度だけ、x402 を使って USDC で支払います。set_custom_domain は、まず支払い要件を返します。

詳細

• esyurl.fyi/llms.txt：エージェント向け API
• esyurl.fyi/openapi.json：REST API
• esyurl/skills：同じ内容をエージェントスキルとして提供します（npx skills add esyurl/skills）

ライセンス

このリポジトリの内容は MIT ライセンスです。