Urlsome

Use Urlsome from your AI assistant

Urlsome is a remote MCP server. Add its URL to Claude, ChatGPT, Cursor or Claude Code, sign in once, then ask for what you need.

https://urlsome.com/mcp

Add it to your assistant

Pick your assistant. The URL is the same for all of them.

Claude claude.ai and desktop app

  1. Open Settings → Connectors.
  2. Select Add custom connector.
  3. Name it Urlsome and paste the URL above.
  4. Select Connect, sign in, and approve access.

ChatGPT

Once Urlsome is listed in the ChatGPT plugin directory, open Settings → Apps & Connectors, find Urlsome and select Connect. Until then, add it as a custom connector:

  1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Back in Apps & Connectors, select Create.
  3. Name it Urlsome, paste the URL above and choose OAuth for authentication.
  4. Select Create, sign in, and approve access.

Cursor

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project. Cursor opens the sign-in page the first time it connects.

{
  "mcpServers": {
    "shortener": {
      "url": "https://urlsome.com/mcp"
    }
  }
}

Claude Code

Run this in a terminal, then run /mcp inside Claude Code to sign in.

claude mcp add --transport http shortener https://urlsome.com/mcp

Or use an API key instead of signing in. Create one in your account.

claude mcp add --transport http shortener https://urlsome.com/mcp \
  --header "Authorization: Bearer sk_shortener_…"

Tools

Read tools only look things up. Write tools create or change things. Destructive tools delete.

  • shorten_linkwriteShorten a linkMakes a short link that redirects to an http or https URL, with a random 6-character slug. Optional: a chosen word as the slug (on the service's own domain limited on this account type to 5 words for now, of 6 or more characters; deleting a link does not free its word), a title, UTM tags added to the destination, and a password asked on a page before the redirect (the destination stays hidden until it is entered). A link with no click in 12 months expires. Returns the link (id, short URL, destination, clicks, whether it is protected), shown in a link card with copy, open and edit.
  • shorten_linkswriteShorten linksMakes up to 50 short links at once, each from a URL with an optional title and chosen word as the slug (on the service's own domain limited on this account type to 5 words for now, of 6 or more characters; deleting a link does not free its word); UTM tags, when given, are added to every destination. Items that fail are listed with the reason without stopping the rest; each link made counts against the account's monthly allowance. Returns the links, shown as a grid.
  • list_linksreadList linksLists the account's short links, newest first, a page at a time (20 by default, up to 100): short URL, destination, title, clicks and status. Returns the links, how many there are in total and a cursor for the next page, shown as a grid.
  • search_linksreadFind linksFinds the account's short links by words in the slug, title or destination (case and accents ignored), by domain and by creation date (YYYY-MM-DD), a page at a time. Returns the matches, best first, how many there are and a cursor for the next page, shown as a grid.
  • get_linkreadShow a linkReturns one of the account's short links, by id, slug or short URL: its destination, title, total clicks and status, shown in a link card.
  • update_linkwriteChange a linkChanges a short link's destination, title or slug (a new chosen word is on the service's own domain limited on this account type to 5 words for now, of 6 or more characters; deleting a link does not free its word); only what is given changes. The short URL keeps working after a destination change, and a previous slug keeps redirecting to the link. Returns the link and its previous destination and slug, shown in the link card.
  • delete_linkdestructiveDelete a linkDeletes a short link and its click counts. Its short URL and any previous slug stop redirecting (they answer not found); the slugs stay reserved to this account.
  • get_link_statsreadClicks of a linkReturns the clicks of a short link per day over the last 7, 30 or 90 days (30 by default) and the total for that window, shown as a chart. Visitors are not identified: no IP address is stored.
  • set_link_passwordwriteSet a link's passwordSets, changes or removes the password of a short link or shared file (a shared file keeps one: it can be changed, not removed). People then enter it on a page before the link opens; a new password closes the sessions already opened with the old one. Returns the link, shown in the link card.
  • share_filewriteShare a file with a passwordShares a file attached in the chat (PDF, PNG, JPEG, WebP or GIF, up to 100 MB; the account stores up to 10 GB of files) as a short link behind a password: people enter the password on a page, then the file opens in their browser. Archives, programs, web pages and SVG images are refused. With link (an existing shared file), its file is replaced and its short URL and password stay. Returns the link (kind file, file name and size), shown in the link card.

Things to ask

  • Shorten this for my Instagram bio: https://maisonverde.co/collections/new-arrivals
  • The bio link should go to the summer sale now: maisonverde.co/summer-sale
  • How many clicks did the bio link get this week?
  • Make short links for these 12 product pages with utm_source=newsletter
  • Share this PDF with a password for the client
  • Give the flyer link a title: Spring event
  • Delete the short link called test-123

Scripts and other clients

Any MCP client that supports Streamable HTTP can connect. Clients without OAuth can send an API key in the Authorization header. The same key works with the HTTP API.

Authorization: Bearer sk_shortener_…