Docs menu

AI assistant connector (MCP)

Connect Claude, ChatGPT, Cursor, VS Code or any MCP client to siz.la to make links and QR codes and read stats by asking.

The siz.la connector lets an AI assistant work with your links. Connect it once and you can ask in plain words: shorten a link, list your links, see how one is doing, archive or delete one, or get a QR code. The assistant acts as you, inside your plan's limits, and never sees your password or your API key.

It is a remote MCP server, which is the open standard assistants use to talk to other services. There is nothing to install.

Text
https://siz.la/mcp

The server uses the Streamable HTTP transport and signs people in with OAuth.

What you can ask

  • "Shorten https://example.com/a/long/address and call it lunch-menu."
  • "How did lunch-menu do over the last 30 days, and where did the clicks come from?"
  • "Show my five newest links and archive the ones I have not shared."
  • "Make a QR code for lunch-menu."
  • "Show my newsletter message over lunch-menu." (Use the message's id from your Call to action page.)
  • "Fire my Meta pixel on lunch-menu and put it in the menu launch campaign."
  • "Is siz.la/open-mic still working, and where does it lead?"

Connect your assistant

Pick your assistant. Menu names change from time to time in the assistants themselves; if yours differ, look for the place that adds a custom or remote MCP server.

Claude

Claude on the web, desktop and phone.

  1. Open Customize, then Connectors.
  2. Choose Add, then Add custom connector.
  3. Enter the name siz.la and the address https://siz.la/mcp.
  4. Choose Continue, then Add and Connect.
  5. Sign in to siz.la if asked, read what the assistant can do and choose Allow.

On Team and Enterprise plans an owner adds the connector once, under Organization settings, then Connectors. Menu names change from time to time; look for the place that adds a custom connector.

Claude Code

The terminal.

  1. Run the command below.
  2. Inside Claude Code run /mcp, pick siz-la and choose to sign in. Your browser opens the siz.la sign-in and consent screen.
Shell
claude mcp add --transport http siz-la https://siz.la/mcp

ChatGPT

ChatGPT on the web.

  1. Open the place in ChatGPT where you add your own connectors and choose to add a custom MCP server.
  2. Enter the name siz.la and the address https://siz.la/mcp.
  3. Choose OAuth for authentication and accept the warning that this is a connection you added yourself.
  4. Create it, then sign in to siz.la and choose Allow.

Which plans can add their own connectors, and what the menu is called, is decided by OpenAI and by your workspace admin. Ask the admin if the option is missing.

Cursor

The Cursor editor.

  1. Add the server to .cursor/mcp.json in a project, or to ~/.cursor/mcp.json for every project.
  2. Cursor shows siz-la under its MCP list with a sign-in button. Sign in to siz.la and choose Allow.
JSON
{
  "mcpServers": {
    "siz-la": {
      "url": "https://siz.la/mcp"
    }
  }
}

Add to Cursor

VS Code

Visual Studio Code with GitHub Copilot chat.

  1. Run MCP: Add Server from the Command Palette and choose HTTP, or add the server to .vscode/mcp.json yourself.
  2. Start the server from the editor. VS Code opens the siz.la sign-in and consent screen. Choose Allow.
JSON
{
  "servers": {
    "siz-la": {
      "type": "http",
      "url": "https://siz.la/mcp"
    }
  }
}

Windsurf

The Windsurf editor.

  1. Open the Cascade MCP menu and choose to open the MCP config file, or use Add Server in Windsurf Settings.
  2. Add the entry below and refresh the server list. Sign in to siz.la and choose Allow.
JSON
{
  "mcpServers": {
    "siz-la": {
      "serverUrl": "https://siz.la/mcp"
    }
  }
}

Gemini CLI

The terminal.

  1. Run the command below.
  2. Inside Gemini CLI run /mcp auth siz-la. Sign in to siz.la and choose Allow.
Shell
gemini mcp add --transport http siz-la https://siz.la/mcp

Other MCP clients

Any client that supports remote MCP servers.

  1. Choose to add a remote MCP server, with the Streamable HTTP transport, and enter https://siz.la/mcp.
  2. The client finds the sign-in on its own: it asks siz.la, gets a 401 answer that points at the sign-in details, registers itself and opens the consent screen.
  3. If a client can only start local programs, run it through a bridge such as mcp-remote and keep the same address.
JSON
{
  "mcpServers": {
    "siz-la": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://siz.la/mcp"]
    }
  }
}

Signing in

The connector uses OAuth 2.1 with PKCE, and assistants register themselves, so you never copy a key.

  1. The assistant calls the server without a token. The server answers 401 with a pointer to its sign-in details at https://siz.la/.well-known/oauth-protected-resource.
  2. The assistant registers itself and sends you to siz.la.
  3. You sign in if needed, and a consent screen shows what the assistant can do, with Allow and Deny.
  4. The assistant gets a token. Every tool call then acts as you.

Access is renewed on its own while the assistant is in use. If it lapses, you are asked to allow it again. You can disconnect every assistant at once under Settings, then Developers. A closed account, or one whose email address is not confirmed, cannot connect.

Limits

The connector follows your plan exactly like the website and the API do. Links are made and changed through the same checks, so blocked addresses, reserved endings and your monthly link limit all apply, and options your plan does not include are refused with a message that says so.

Requests are limited per minute by plan, in a count of their own, apart from your API requests:

PlanRequests a minuteAPI accessLinks a monthRaw clicks kept
Free60Read and change500365 days
Pro120Read and change5,0001,095 days
Team300Read and change25,0003,650 days
Business600Read and change100,000No limit
Organization1,200Read and changeAgreed per customerNo limit

A link or click that belongs to someone else looks the same as one that does not exist.

Tools

These are the tools the assistant can call. Each one is marked as read only or as one that changes something, and one cannot be undone. The assistant is told to confirm before using that one. The list is read from the server's own tool registry.

Changes data

Make a short siz.la address for a long web address. Returns the short address and the link's id. Safety checks run on every destination, and the account's monthly link limit applies. Password, expiry and click limits work on every plan, the free one included. It can also put the link in a campaign and fire the account's ad pixels on each click.

InputTypeWhat it means
destination (required)stringThe full web address to shorten. It must start with http:// or https://. Up to 4000 characters.
codestringA custom code for the short address, for example lunch-menu. Letters, numbers, dashes and underscores. Leave it out to get a random one. Length 3 to 60.
domainstringOne of the account's connected custom domains, such as go.example.com, to make the link on. Leave it out to use siz.la. Up to 191 characters.
campaignstringA campaign to put the link in, by name. A campaign that does not exist yet is made. Needs a paid plan. Up to 80 characters. Needs Pro and the plans above it.
expires_atstringWhen the link stops working, as a date and time such as 2026-12-31 18:00. Up to 40 characters.
passwordstringA password visitors must enter before they are sent on. Up to 191 characters.
titlestringA name for the link. Only the account owner sees it. Up to 191 characters.
cta_idintegerThe id of one of the account's call-to-action messages (made on siz.la under Call to action) to show over the page the link opens. At least 1.
pixelsarrayIds of the account's ad pixels to fire on each click, as listed by list_pixels. Up to 10.

Read only

List the account's links, newest first, with code, short address, destination, clicks and creation date. Search by part of the code, destination or title.

InputTypeWhat it means
qstringText to look for in the code, destination or title. Up to 200 characters.
pageintegerWhich page of results to return. At least 1. Default 1.
per_pageintegerHow many links to return on a page. 1 to 50. Default 15.
statusstringWhich links to list: active or archived. One of active, archived. Default active.

Read only

Show how a link is doing: total and unique clicks, new and returning visitors, clicks by day, busiest hours of the week, top countries, top referrers, visits from AI assistants such as ChatGPT or Claude, browsers, systems and devices. For a bio page it also gives views and clicks for each button, and on a paid plan the conversions. Visits from bots are reported apart and are not in the totals.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.
daysintegerHow many days back to report: 7, 30 or 90. The plan may keep less history than that. One of 7, 30, 90. Default 30.

Get conversions get_conversions

Read only

Show the sign-ups and sales counted against a link's clicks: how many, what share of clicks they are, their value for each currency, and the newest ones. Leave out the link to cover the whole account. Needs a paid plan.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.
daysintegerHow many days back to report: 7, 30 or 90. One of 7, 30, 90. Default 30.

Changes dataSafe to repeat

Change one of the account's links. Only the fields you send change. The short address stays the same. Expiry, password and click limit work on every plan. It can also change the campaign and the pixels. Leave pixels out to keep them as they are; send an empty list to remove them.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.
destinationstringThe new full web address the link leads to. It must start with http:// or https://. Up to 4000 characters.
titlestringA new name for the link. Send an empty string to remove it. Up to 191 characters.
expires_atstringWhen the link stops working, as a date and time such as 2026-12-31 18:00. Send an empty string to remove the expiry. Up to 40 characters.
passwordstringA password visitors must enter before they are sent on. Send an empty string to remove it. Up to 191 characters.
click_limitintegerThe link stops working after this many clicks. Send 0 to remove the limit. At least 0.
cta_idintegerThe id of one of the account's call-to-action messages to show over the page the link opens. Send 0 to remove it. At least 0.
campaignstringMove the link into a campaign, by name. A campaign that does not exist yet is made. Send an empty string to take the link out of its campaign. Up to 80 characters. Needs Pro and the plans above it.
pixelsarrayIds of the account's ad pixels to fire on each click, as listed by list_pixels. An empty list removes them. Up to 10.

Changes dataSafe to repeat

Move a link to the archive. It keeps working and keeps its stats; it is only hidden from the main list. Restore it with restore_link.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.

Changes dataSafe to repeat

Bring an archived link back to the main list.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.

Changes dataCannot be undoneSafe to repeat

Delete a link and its stats for good. The short address stops working and cannot be used again. This cannot be undone, so confirm with the person first. To keep the stats, use archive_link instead.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.

Make a QR code make_qr_code

Read only

Get the address of a QR code image for one of the account's links. The image is an SVG. Scans count as clicks on the link.

InputTypeWhat it means
idintegerThe link's id, as returned by list_links or shorten_link. Give either id or code. At least 1.
codestringThe link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters.

List domains list_domains

Read only

List the domains the account can shorten links on: siz.la and any connected custom domains.

No inputs.

List campaigns list_campaigns

Read only

List the account's campaigns with how many links each holds and their clicks over the last 30 days.

No inputs.

Make a campaign create_campaign

Changes data

Make a campaign to group links, read their clicks together and give them shared UTM values. Put links in it with the campaign option of shorten_link or update_link.

InputTypeWhat it means
name (required)stringThe campaign's name. It must be different from the account's other campaigns. Up to 80 characters. Needs Pro and the plans above it.
utm_sourcestringAdded to the address of every link in the campaign as utm_source. Up to 100 characters.
utm_mediumstringAdded as utm_medium. Up to 100 characters.
utm_campaignstringAdded as utm_campaign. Up to 100 characters.

Update a campaign update_campaign

Changes dataSafe to repeat

Rename a campaign or change its UTM values. Only the fields you send change. New UTM values reach a link the next time it is saved or added to the campaign.

InputTypeWhat it means
id (required)integerThe campaign's id, as returned by list_campaigns. At least 1.
namestringA new name. Up to 80 characters.
utm_sourcestringA new utm_source. Send an empty string to remove it. Up to 100 characters.
utm_mediumstringA new utm_medium. Send an empty string to remove it. Up to 100 characters.
utm_campaignstringA new utm_campaign. Send an empty string to remove it. Up to 100 characters.

List pixels list_pixels

Read only

List the account's ad pixels with their ids, to pass as "pixels" when shortening or updating a link.

No inputs.

Read only

Check any siz.la short address, whoever owns it: whether it exists, was removed, or has expired, and where it leads. It never shows the destination of a password-protected link and never says who owns a link.

InputTypeWhat it means
link (required)stringA siz.la short address such as https://siz.la/lunch-menu, or just its code. Up to 500 characters.

From code

The REST API does the same jobs without an assistant. See (https://siz.la/docs/links).

Questions

Can I use siz.la from Claude or ChatGPT?

Yes. Add https://siz.la/mcp as a custom connector (a remote MCP server), sign in to siz.la and choose Allow. The assistant can then make links, list them, read stats and get QR codes for you.

Does the AI assistant see my password or API key?

No. The connector signs in with OAuth, so the assistant only gets a token that acts as your account. You can disconnect every assistant under Settings, then Developers.

Which plan do I need for the connector?

Any plan. The assistant works inside the limits of your plan, the same as the website and the API.