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.
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.
- Open Customize, then Connectors.
- Choose Add, then Add custom connector.
- Enter the name siz.la and the address https://siz.la/mcp.
- Choose Continue, then Add and Connect.
- 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.
- Run the command below.
- Inside Claude Code run /mcp, pick siz-la and choose to sign in. Your browser opens the siz.la sign-in and consent screen.
claude mcp add --transport http siz-la https://siz.la/mcpChatGPT
ChatGPT on the web.
- Open the place in ChatGPT where you add your own connectors and choose to add a custom MCP server.
- Enter the name siz.la and the address https://siz.la/mcp.
- Choose OAuth for authentication and accept the warning that this is a connection you added yourself.
- 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.
- Add the server to .cursor/mcp.json in a project, or to ~/.cursor/mcp.json for every project.
- Cursor shows siz-la under its MCP list with a sign-in button. Sign in to siz.la and choose Allow.
{
"mcpServers": {
"siz-la": {
"url": "https://siz.la/mcp"
}
}
}VS Code
Visual Studio Code with GitHub Copilot chat.
- Run MCP: Add Server from the Command Palette and choose HTTP, or add the server to .vscode/mcp.json yourself.
- Start the server from the editor. VS Code opens the siz.la sign-in and consent screen. Choose Allow.
{
"servers": {
"siz-la": {
"type": "http",
"url": "https://siz.la/mcp"
}
}
}Windsurf
The Windsurf editor.
- Open the Cascade MCP menu and choose to open the MCP config file, or use Add Server in Windsurf Settings.
- Add the entry below and refresh the server list. Sign in to siz.la and choose Allow.
{
"mcpServers": {
"siz-la": {
"serverUrl": "https://siz.la/mcp"
}
}
}Gemini CLI
The terminal.
- Run the command below.
- Inside Gemini CLI run /mcp auth siz-la. Sign in to siz.la and choose Allow.
gemini mcp add --transport http siz-la https://siz.la/mcpOther MCP clients
Any client that supports remote MCP servers.
- Choose to add a remote MCP server, with the Streamable HTTP transport, and enter https://siz.la/mcp.
- 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.
- If a client can only start local programs, run it through a bridge such as mcp-remote and keep the same address.
{
"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.
- The assistant calls the server without a token. The server answers
401with a pointer to its sign-in details athttps://siz.la/.well-known/oauth-protected-resource. - The assistant registers itself and sends you to siz.la.
- You sign in if needed, and a consent screen shows what the assistant can do, with Allow and Deny.
- 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:
| Plan | Requests a minute | API access | Links a month | Raw clicks kept |
|---|---|---|---|---|
| Free | 60 | Read and change | 500 | 365 days |
| Pro | 120 | Read and change | 5,000 | 1,095 days |
| Team | 300 | Read and change | 25,000 | 3,650 days |
| Business | 600 | Read and change | 100,000 | No limit |
| Organization | 1,200 | Read and change | Agreed per customer | No 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.
Shorten a link shorten_link
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.
| Input | Type | What it means |
|---|---|---|
destination (required) | string | The full web address to shorten. It must start with http:// or https://. Up to 4000 characters. |
code | string | A 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. |
domain | string | One 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. |
campaign | string | A 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_at | string | When the link stops working, as a date and time such as 2026-12-31 18:00. Up to 40 characters. |
password | string | A password visitors must enter before they are sent on. Up to 191 characters. |
title | string | A name for the link. Only the account owner sees it. Up to 191 characters. |
cta_id | integer | The 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. |
pixels | array | Ids of the account's ad pixels to fire on each click, as listed by list_pixels. Up to 10. |
List links list_links
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.
| Input | Type | What it means |
|---|---|---|
q | string | Text to look for in the code, destination or title. Up to 200 characters. |
page | integer | Which page of results to return. At least 1. Default 1. |
per_page | integer | How many links to return on a page. 1 to 50. Default 15. |
status | string | Which links to list: active or archived. One of active, archived. Default active. |
Get link stats get_link_stats
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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters. |
days | integer | How 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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters. |
days | integer | How many days back to report: 7, 30 or 90. One of 7, 30, 90. Default 30. |
Update a link update_link
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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters. |
destination | string | The new full web address the link leads to. It must start with http:// or https://. Up to 4000 characters. |
title | string | A new name for the link. Send an empty string to remove it. Up to 191 characters. |
expires_at | string | When 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. |
password | string | A password visitors must enter before they are sent on. Send an empty string to remove it. Up to 191 characters. |
click_limit | integer | The link stops working after this many clicks. Send 0 to remove the limit. At least 0. |
cta_id | integer | The 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. |
campaign | string | Move 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. |
pixels | array | Ids of the account's ad pixels to fire on each click, as listed by list_pixels. An empty list removes them. Up to 10. |
Archive a link archive_link
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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters. |
Restore a link restore_link
Changes dataSafe to repeat
Bring an archived link back to the main list.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The link's code (the part after siz.la/) or its full short address. Give either id or code. Up to 400 characters. |
Delete a link delete_link
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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The 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.
| Input | Type | What it means |
|---|---|---|
id | integer | The link's id, as returned by list_links or shorten_link. Give either id or code. At least 1. |
code | string | The 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.
| Input | Type | What it means |
|---|---|---|
name (required) | string | The 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_source | string | Added to the address of every link in the campaign as utm_source. Up to 100 characters. |
utm_medium | string | Added as utm_medium. Up to 100 characters. |
utm_campaign | string | Added 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.
| Input | Type | What it means |
|---|---|---|
id (required) | integer | The campaign's id, as returned by list_campaigns. At least 1. |
name | string | A new name. Up to 80 characters. |
utm_source | string | A new utm_source. Send an empty string to remove it. Up to 100 characters. |
utm_medium | string | A new utm_medium. Send an empty string to remove it. Up to 100 characters. |
utm_campaign | string | A 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.
Check a link check_link
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.
| Input | Type | What it means |
|---|---|---|
link (required) | string | A 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.