URLinks MCP server
Commit Nov 8, 2026Allows AI agents to create and manage short links, QR codes, link-in-bio pages, and access click analytics.
Also known as lwolfowitz/urlinks-mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 0.3.2
- Last commit
- Nov 8, 2026
- License
- MIT
What is URLinks MCP?
URLinks allows AI agents to create and manage short links, QR codes, link-in-bio pages, and access click analytics. It exposes 8 tools, such as create_shortlink, list_links, search_links.
Summary generated from the project's README
About URLinks MCP server
URLinks provides a hosted MCP server that connects AI agents to a URL management platform. Developers using Claude Code, Cursor, or Windsurf can integrate this service by pointing their client to the URLinks API endpoint and providing an API key via a bearer header. This setup requires no local installation because it operates as a streamable HTTP service.
The server gives agents the ability to manage the entire lifecycle of short links, including creating, editing, searching, and deleting them. Beyond simple redirection, it offers deep integration for link-in-bio profile management. Agents can use tools like add_block_v2 to manage galleries or products, update_page_style to change themes, and get_link_analytics to retrieve click counts and daily performance data.
What you can do with it
- 1Generate short URLs from documentationAn AI agent can scan a README file and automatically generate short links for every URL found within it.
- 2Monitor link performanceYou can ask your AI client to retrieve specific click statistics and daily breakdowns for your existing links.
- 3Customize link-in-bio profilesDevelopers can instruct an agent to update their profile bio, avatar, or visual themes using specialized profile tools.
- 4Organize and find linksAn agent can search through your entire collection of short links based on their names, descriptions, or destination URLs.
Written from the project's README. Every use case is checked against a quote from it.
How to install URLinks MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall URLinks MCP in Claude Code
$ claude mcp add --transport http urlinks https://urlinks.me/api/mcpInstall URLinks MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"urlinks": {
"url": "https://urlinks.me/api/mcp"
}
}
}Install URLinks MCP in VS Code
.vscode/mcp.json
{
"servers": {
"urlinks": {
"type": "http",
"url": "https://urlinks.me/api/mcp"
}
}
}Install URLinks MCP in VS Code CLI
$ code --add-mcp '{"name":"urlinks","type":"http","url":"https://urlinks.me/api/mcp"}'Install URLinks MCP in Codex
$ codex mcp add urlinks --url https://urlinks.me/api/mcpInstall URLinks MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.urlinks] url = "https://urlinks.me/api/mcp"
Install URLinks MCP in Gemini CLI
$ gemini mcp add -s user --transport http urlinks https://urlinks.me/api/mcpInstall URLinks MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"urlinks": {
"url": "https://urlinks.me/api/mcp",
"type": "http"
}
}
}URLinks MCP tools 8
Detected from the READMEcreate_shortlinklist_linkssearch_linksget_link_analyticsedit_linkdelete_linkadd_blocksubmit_custom_css
| create_shortlink | — | |
| list_links | — | |
| search_links | — | |
| get_link_analytics | — | |
| edit_link | — | |
| delete_link | — | |
| add_block | — | |
| submit_custom_css | — |
Automated checks
Ran Nov 14, 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 reachablelwolfowitz/urlinks-mcp is public and reachablegithub.com/lwolfowitz/urlinks-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-11-08github.com/lwolfowitz/urlinks-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 model8 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 321 msPass
README
View on GitHub@urlinks/mcp-server
MCP server for URLinks — the AI-friendly URL shortener.
Gives Claude Code, Cursor, Windsurf, and any MCP-compatible AI agent native access to your shortlinks.
Setup
1. Get an API key
Sign in to your URLinks dashboard and create an API key in Settings.
2. Add to your AI tool
URLinks is a hosted MCP server (Streamable HTTP) — there's nothing to install. Point your client at https://urlinks.me/api/mcp and pass your API key as a bearer header.
Claude Code (~/.claude.json or a project .mcp.json):
{
"mcpServers": {
"urlinks": {
"type": "http",
"url": "https://urlinks.me/api/mcp",
"headers": {
"Authorization": "Bearer urk_your_key_here"
}
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"urlinks": {
"url": "https://urlinks.me/api/mcp",
"headers": {
"Authorization": "Bearer urk_your_key_here"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
create_shortlink |
Create a new shortlink (e.g., my/docs -> https://docs.google.com/...) |
list_links |
List all your shortlinks with pagination |
search_links |
Search links by name, URL, or description |
get_link_analytics |
Get click counts and daily breakdown for a link |
edit_link |
Update a link's destination URL or description |
delete_link |
Permanently delete a shortlink |
Profile tools (link-in-bio)
See docs/profile-plans/2026-06-03-api-mcp-parity-spec.md for the full parity checklist.
| Tool | Description |
|---|---|
get_profile / update_profile |
Read/update display name, bio, avatar |
add_block |
Basic blocks (legacy) |
add_block_v2 |
Full block types: gallery, countdown, product, embed presets |
update_page_style |
Themes, scenes, layout, socialIconStyle, strokes, … |
update_block |
Per-block content/style, feature links, animations |
apply_theme / set_theme |
Apply @urlinks/profile-presets themes |
list_profile_style_options |
Fonts, scenes, gradients, embed providers |
submit_custom_css |
Sanitized CSS per concern |
Once configured, just ask your AI:
- "Create a shortlink
my/standuppointing to our standup doc" - "How many clicks did
my/blogget this week?" - "List all my links about documentation"
- "Create shortlinks for all the URLs in this README"
Auth
Pass your API key (starts with urk_) as Authorization: Bearer <key> to https://urlinks.me/api/mcp. Create a key in your URLinks dashboard settings.
The server side honors URLINKS_API_URL to override the backend base URL (self-hosting/dev); clients don't need it.
URLinks MCP questions
How do I add URLinks MCP to Claude Code?
Run claude mcp add --transport http urlinks https://urlinks.me/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add URLinks 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 URLinks MCP provide?
It exposes 8 tools, including create_shortlink, list_links, search_links, get_link_analytics, edit_link.
How do I set up URLinks with my AI tool?
URLinks is a hosted MCP server that you connect to by pointing your client to the URL and passing your API key as a bearer header.
What tools are available for link management?
You can create, list, search, edit, and delete shortlinks, as well as retrieve click analytics.