esyURL MCP server
Commit Oct 7, 2026Lets AI agents create short links, generate styled QR codes, manage redirects, and track scan statistics.
Also known as esyurl/mcp, mcp
- Stars
- 0
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 7, 2026
- License
- MIT
What is esyURL MCP?
esyURL lets AI agents create short links, generate styled QR codes, manage redirects, and track scan statistics. It exposes 9 tools, such as create_short_link, list_short_links, get_short_link.
Summary generated from the project's README
About esyURL MCP server
Managing short links and QR codes directly through an AI agent is what esyURL enables. Developers can use this hosted MCP server to automate the creation of shortened URLs, generate styled PNG QR codes with custom colors or logos, and manage complex redirect rules based on a visitor's device or country. The server operates via a streamable HTTP endpoint, making it compatible with clients like Claude Code, Cursor, or VS Code using a bearer token for authentication.
Agents can autonomously sign up for an account to begin working, with self-signed accounts receiving a limit of 100 links. This capacity increases to 1000 links once a human claims the account via email. Beyond simple shortening, the toolset includes capabilities for organizing links into groups, tracking detailed visit statistics split by QR scans and direct clicks, and even setting up custom domains. It provides specific tools like test_redirect_rules to verify how different devices are routed before deployment.
What you can do with it
- 1Generate branded QR codesAsk the agent to create a PNG QR code with specific module shapes, colors, or a logo for a specific link.
- 2Automate device-based routingHave the AI set up a link that sends iPhone users to the App Store and Android users to Google Play.
- 3Monitor link performanceRequest a breakdown of daily visits to see how many came from QR scans versus direct clicks.
- 4Update existing marketing assetsChange the destination of a previously shared short link without needing to print new QR codes.
Written from the project's README. Every use case is checked against a quote from it.
How to install esyURL MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall esyURL MCP in Claude Code
$ claude mcp add --transport http mcp https://esyurl.fyi/mcpInstall esyURL MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://esyurl.fyi/mcp"
}
}
}Install esyURL MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://esyurl.fyi/mcp"
}
}
}Install esyURL MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://esyurl.fyi/mcp"}'Install esyURL MCP in Codex
$ codex mcp add mcp --url https://esyurl.fyi/mcpInstall esyURL MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://esyurl.fyi/mcp"
Install esyURL MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://esyurl.fyi/mcpInstall esyURL MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://esyurl.fyi/mcp",
"type": "http"
}
}
}esyURL MCP tools 9
Detected from the READMEcreate_short_linklist_short_linksget_short_linkupdate_short_linkdelete_short_linktest_redirect_rulesget_short_link_visitsrender_qr_codeget_group_visits
| create_short_link | — | |
| list_short_links | — | |
| get_short_link | — | |
| update_short_link | — | |
| delete_short_link | — | |
| test_redirect_rules | — | |
| get_short_link_visits | — | |
| render_qr_code | — | |
| get_group_visits | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableesyurl/mcp is public and reachablegithub.com/esyurl/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-07github.com/esyurl/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 241 msPass
README
View on GitHubesyURL 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.
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
| Tool | What it does |
|---|---|
create_short_link |
Shorten a URL, with an optional custom slug, QR style and redirect rules |
list_short_links |
List your links, optionally by tag or group |
get_short_link |
One link, with its groups and lifetime visit count |
update_short_link |
Change where a link points, its QR style or rules, or pause it; the short URL and printed QR codes keep working |
delete_short_link |
Delete a link |
test_redirect_rules |
Check which destination a visitor would get (e.g. iPhone to the App Store, Android to Google Play) |
get_short_link_visits |
Visits per day, split into QR scans, direct clicks and bots |
render_qr_code |
A 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_group |
Organise links into groups |
add_links_to_group, remove_link_from_group |
Group membership |
get_group_visits |
Combined visits for a group |
get_custom_domain, set_custom_domain, remove_custom_domain |
Short 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
- 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.
esyURL MCP questions
How do I add esyURL MCP to Claude Code?
Run claude mcp add --transport http mcp https://esyurl.fyi/mcp in your terminal. Add --scope user to make it available in every project.
How do I add esyURL MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does esyURL MCP provide?
It exposes 9 tools, including create_short_link, list_short_links, get_short_link, update_short_link, delete_short_link.
How many links can I create with a self-signed account?
Self-signed-up accounts are limited to 100 links, which increases to 1000 once a human claims the account via email.
Does the agent need a human to create an account?
No, the agent can sign itself up without a human account being required.