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.

Related MCP server: DWZ Short URL MCP Server

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

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

• esyurl.fyi/llms.txt: the API for agents

• esyurl.fyi/openapi.json: REST API

• esyurl/skills: the same, as agent skills (npx skills add esyurl/skills)

License

MIT, for the contents of this repository.