{"serverId":"mcp-registry/io.github.esyurl/mcp","tools":[{"name":"add_links_to_group","fixed":{"name":"add_links_to_group","description":"Add up to 25 links to a group in one call. Idempotent: links already in the group are reported in alreadyMembers rather than failing. Fails with not_found if any linkId is unknown (nothing is added).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["groupId","linkIds"],"properties":{"groupId":{"type":"string","minLength":1,"description":"The group id (groupId), as returned by create_group or list_groups"},"linkIds":{"type":"array","items":{"type":"string"},"description":"1-25 linkIds"}}},"annotations":{"idempotentHint":false,"readOnlyHint":false,"destructiveHint":false},"title":"Add links to group"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":163,"tokensAfter":163},{"name":"create_group","fixed":{"name":"create_group","description":"Create a group to organise short links (e.g. a campaign or a venue). Groups are many-to-many: a link can be in up to 20 groups. Add links with add_links_to_group, or pass groupIds when creating/updating a link.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["name"],"properties":{"name":{"type":"string","description":"Group name, up to 100 chars"},"color":{"type":"string","description":"Hex colour for UIs, e.g. #3366ff"},"description":{"type":"string","description":"Up to 500 chars"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false},"title":"Create group"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":161,"tokensAfter":161},{"name":"create_short_link","fixed":{"name":"create_short_link","description":"Create a short link that redirects to targetUrl, or shows a link page (pass page instead of targetUrl). Returns the link, including linkId (use it with the other tools) and shortUrl (share this). Give a slug for a memorable URL, otherwise a random 8-character one is generated. Slugs are unique across all tenants and cannot be changed later (409 if taken; route names like \"api\", \"admin\", \"health\" are reserved).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"type":"string","description":"Human label, up to 200 chars"},"page":{"type":"object","description":"A link page (link in bio): instead of redirecting, the short URL shows a page with a title, an optional avatar and bio, a list of buttons and a row of social icons, styled by a theme. Rules still apply first: a matching rule redirects. Shape: {title (≤80), bio? (≤300), avatar? {data: \"data:image/png;base64,...\"} or {imageId} to keep the current one, items: [{type: \"link\", label, url} | {type: \"link\", label, linkId} (another of your links: opens its short URL) | {type: \"header\", text} | {type: \"text\", text}], socials?: [{platform, url}], theme?, language?, noindex?, footer?}. Items take id? (stable, clicks are counted by it; generated if omitted, keep it when editing), enabled? (default true), when? (a condition in the redirect-rule grammar: the item shows only to matching visits, e.g. {\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"}), and link items highlight? (accent colour) and thumbnail? (a picture). Up to 50 items and 8 pictures. socials platforms: instagram, tiktok, youtube, x, facebook, linkedin, github, threads, bluesky, mastodon, whatsapp, telegram, spotify, twitch, discord, pinterest, snapchat, substack, email, website (email takes mailto:). theme: {preset? (light|dark|midnight|sunset|forest|pastel|mono, default light), background? {type: \"solid\", color} | {type: \"gradient\", from, to, angle?} | {type: \"image\", image: {data}, dim? 0-0.8}, text? (hex colour), font? (system|rounded|serif|mono|condensed), button? {shape? (square|rounded|pill), fill? (solid|outline|soft|shadow), color?, text?}, avatarShape? (circle|rounded|square), align? (center|left)}. Low-contrast colours come back as `warnings` but are saved. Pages of self-signed-up tenants carry a small \"Made with esyURL · Report\" footer; footer: false removes it for a one-off x402 payment per page (see payment).","propertyNames":{"type":"string"},"additionalProperties":{}},"slug":{"type":"string","description":"Custom slug, ^[a-zA-Z0-9_-]{3,64}$; random if omitted"},"tags":{"type":"array","items":{"type":"string"},"description":"Free-form labels, up to 20; filter with list_short_links tag"},"rules":{"type":"array","items":{"type":"object","required":["when","targetUrl"],"properties":{"id":{"type":"string","description":"Stable id, shown on visits; generated if omitted. Keep it when editing a rule"},"name":{"type":"string"},"when":{"type":"object","description":"The condition, e.g. {\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"}","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean","description":"Default true; false keeps the rule but skips it"},"targetUrl":{"type":"string","description":"Absolute http(s) destination when this rule matches"}}},"description":"Redirect rules, evaluated in order on every visit; the first enabled rule whose \"when\" matches sends the visitor to its targetUrl, otherwise the link's targetUrl is used. A condition is either a test {field, op, value} or a combination {all: [...]}, {any: [...]}, {not: {...}}. Fields and their ops: os (ios|android|windows|macos|linux|chromeos|other), device (mobile|tablet|desktop|bot), browser (safari|chrome|firefox|edge|samsung|opera|in_app|other), source (qr|direct|bot): eq, neq, in, not_in. language (Accept-Language primary tag; \"pt\" also matches \"pt-BR\"): eq, neq, in, not_in, exists. country (ISO 3166-1 alpha-2, e.g. \"GB\", geolocated by the edge on every host): eq, neq, in, not_in. An unknown or absent value fails eq/in and passes neq/not_in. referrer (host, e.g. instagram.com) and query (needs \"key\", the parameter name): eq, neq, in, not_in, contains, starts_with, ends_with, exists. time (ISO timestamp): before, after. weekday (sun..sat, UTC): eq, neq, in, not_in. hour (0-23 UTC): eq, neq, in, not_in, gte, lte. in/not_in take an array. Text compares case-insensitively. Up to 20 rules, 20 conditions per rule. Example app-store split: [{\"name\":\"iOS\",\"when\":{\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"},\"targetUrl\":\"https://apps.apple.com/app/id123\"},{\"name\":\"Android\",\"when\":{\"field\":\"os\",\"op\":\"eq\",\"value\":\"android\"},\"targetUrl\":\"https://play.google.com/store/apps/details?id=com.example\"}]"},"payment":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}],"description":"Only for footer: false on a page that has not been paid off, by a self-signed-up tenant: the tool first returns an error whose structuredContent is an x402 PaymentRequired; retry with the signed PaymentPayload in _meta[\"x402/payment\"], or, if your client cannot set _meta, here (an object or base64)."},"qrStyle":{"type":"object","properties":{"dark":{"type":"string","description":"Hex colour, e.g. #000000 (the # is optional)"},"image":{"type":"object","required":["mode"],"properties":{"data":{"type":"string","description":"A new picture, as a data URL"},"mode":{"enum":["logo","halftone"],"type":"string"},"size":{"type":"number"},"imageId":{"type":"string","description":"Keep the picture the link already has (its qrStyle.image.imageId)"}},"description":"A picture in the code. mode \"logo\": in the middle (error correction becomes H; size is its side as a share of the code, 0.1-0.3, default 0.22). mode \"halftone\": a photo behind the code, drawn as dots over it. data is a data URL (data:image/png;base64,... png, jpeg, webp or gif, up to 2 MB). To keep the current picture while changing other fields, pass its imageId instead of data."},"light":{"type":"string","description":"Hex colour, e.g. #000000 (the # is optional)"},"margin":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Quiet zone in modules, 0-16"},"eyeBall":{"enum":["square","rounded","circle"],"type":"string","description":"Centre of the corner markers"},"modules":{"enum":["square","rounded","dot","row","column"],"type":"string","description":"Shape of the data modules (default square)"},"eyeColor":{"type":"string","description":"Colour of the corner markers; defaults to dark"},"eyeFrame":{"enum":["square","rounded","circle"],"type":"string","description":"Outer ring of the three corner markers"},"errorCorrectionLevel":{"enum":["L","M","Q","H"],"type":"string","description":"QR error correction level: L 7%, M 15% (default), Q 25%, H 30%"}},"description":"Default look of this link's QR image (free): colours, module and corner-marker shapes, and an optional picture. Styled codes need dark on light with at least 3:1 contrast. The whole style is replaced on update."},"groupIds":{"type":"array","items":{"type":"string"},"description":"Ids of groups (from create_group/list_groups) this link belongs to, up to 20"},"metadata":{"type":"object","description":"Up to 20 string key/value pairs for your own bookkeeping","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"targetUrl":{"type":"string","description":"Absolute http(s) URL visitors are redirected to (exclusive with page)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false},"title":"Create short link"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":2120,"tokensAfter":2120},{"name":"remove_link_from_group","fixed":{"name":"remove_link_from_group","description":"Take one link out of a group. The link itself is untouched.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["groupId","linkId"],"properties":{"linkId":{"type":"string","minLength":1,"description":"The link id (linkId), as returned by create_short_link or list_short_links"},"groupId":{"type":"string","minLength":1,"description":"The group id (groupId), as returned by create_group or list_groups"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true},"title":"Remove link from group"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":139,"tokensAfter":139},{"name":"set_custom_domain","fixed":{"name":"set_custom_domain","description":"Serve all of this tenant's short links on a domain it controls, e.g. \"go.acme.com\" → https://go.acme.com/{slug}. Once active, new short URLs and QR codes use it; links keep working on the platform domain too. One domain per tenant: setting a different one replaces (and tears down) the current one. Setting the same one again is harmless, and restarts it if it failed. Two DNS records are needed at the domain's DNS provider, returned one at a time: first a record (TXT or CNAME) that proves control ","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["domain"],"properties":{"domain":{"type":"string","description":"Bare hostname you control, e.g. go.acme.com - no scheme, port or path"},"payment":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}],"description":"Only if your client cannot send _meta[\"x402/payment\"]: the x402 PaymentPayload, as an object or base64"}}},"annotations":{"idempotentHint":true,"readOnlyHint":false,"destructiveHint":false},"title":"Set custom domain"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":284,"tokensAfter":284},{"name":"set_domain_home_page","fixed":{"name":"set_domain_home_page","description":"Choose the link that the root (/) of this tenant's custom domain shows: a link page becomes the domain's home page, a redirect link sends / there. Pass linkId null to clear it (/ answers 404 again). Has no effect on the platform domain.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["linkId"],"properties":{"linkId":{"type":["string","null"],"description":"The link to show at /, or null to clear"}}},"annotations":{"idempotentHint":true,"readOnlyHint":false,"destructiveHint":false},"title":"Set custom domain home page"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":139,"tokensAfter":139},{"name":"update_group","fixed":{"name":"update_group","description":"Rename a group or change its description or color. Membership doesn't change here.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["groupId"],"properties":{"name":{"type":"string","description":"Group name, up to 100 chars"},"color":{"type":"string","description":"Hex colour for UIs, e.g. #3366ff"},"groupId":{"type":"string","minLength":1,"description":"The group id (groupId), as returned by create_group or list_groups"},"description":{"type":"string","description":"Up to 500 chars"}}},"annotations":{"idempotentHint":true,"readOnlyHint":false,"destructiveHint":false},"title":"Update group"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":161,"tokensAfter":161},{"name":"update_short_link","fixed":{"name":"update_short_link","description":"Change a short link. Only the fields you pass change; tags, metadata, qrStyle and groupIds are replaced wholesale (pass the full new list; [] clears). Set targetUrl to send visitors somewhere else: the short URL and printed QR codes keep working. Set status \"paused\" to make the short URL answer 410, \"active\" to resume. The slug cannot be changed. page replaces the whole link page (a redirect becomes a page); page: null with a targetUrl turns a page back into a redirect.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["linkId"],"properties":{"name":{"type":"string"},"page":{"anyOf":[{"type":"object","description":"A link page (link in bio): instead of redirecting, the short URL shows a page with a title, an optional avatar and bio, a list of buttons and a row of social icons, styled by a theme. Rules still apply first: a matching rule redirects. Shape: {title (≤80), bio? (≤300), avatar? {data: \"data:image/png;base64,...\"} or {imageId} to keep the current one, items: [{type: \"link\", label, url} | {type: \"link\", label, linkId} (another of your links: opens its short URL) | {type: \"header\", text} | {type: \"text\", text}], socials?: [{platform, url}], theme?, language?, noindex?, footer?}. Items take id? (stable, clicks are counted by it; generated if omitted, keep it when editing), enabled? (default true), when? (a condition in the redirect-rule grammar: the item shows only to matching visits, e.g. {\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"}), and link items highlight? (accent colour) and thumbnail? (a picture). Up to 50 items and 8 pictures. socials platforms: instagram, tiktok, youtube, x, facebook, linkedin, github, threads, bluesky, mastodon, whatsapp, telegram, spotify, twitch, discord, pinterest, snapchat, substack, email, website (email takes mailto:). theme: {preset? (light|dark|midnight|sunset|forest|pastel|mono, default light), background? {type: \"solid\", color} | {type: \"gradient\", from, to, angle?} | {type: \"image\", image: {data}, dim? 0-0.8}, text? (hex colour), font? (system|rounded|serif|mono|condensed), button? {shape? (square|rounded|pill), fill? (solid|outline|soft|shadow), color?, text?}, avatarShape? (circle|rounded|square), align? (center|left)}. Low-contrast colours come back as `warnings` but are saved. Pages of self-signed-up tenants carry a small \"Made with esyURL · Report\" footer; footer: false removes it for a one-off x402 payment per page (see payment).","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"tags":{"type":"array","items":{"type":"string"},"description":"Free-form labels, up to 20; filter with list_short_links tag"},"rules":{"type":"array","items":{"type":"object","required":["when","targetUrl"],"properties":{"id":{"type":"string","description":"Stable id, shown on visits; generated if omitted. Keep it when editing a rule"},"name":{"type":"string"},"when":{"type":"object","description":"The condition, e.g. {\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"}","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean","description":"Default true; false keeps the rule but skips it"},"targetUrl":{"type":"string","description":"Absolute http(s) destination when this rule matches"}}},"description":"The complete new rule list; replaces the current one ([] removes all). Redirect rules, evaluated in order on every visit; the first enabled rule whose \"when\" matches sends the visitor to its targetUrl, otherwise the link's targetUrl is used. A condition is either a test {field, op, value} or a combination {all: [...]}, {any: [...]}, {not: {...}}. Fields and their ops: os (ios|android|windows|macos|linux|chromeos|other), device (mobile|tablet|desktop|bot), browser (safari|chrome|firefox|edge|samsung|opera|in_app|other), source (qr|direct|bot): eq, neq, in, not_in. language (Accept-Language primary tag; \"pt\" also matches \"pt-BR\"): eq, neq, in, not_in, exists. country (ISO 3166-1 alpha-2, e.g. \"GB\", geolocated by the edge on every host): eq, neq, in, not_in. An unknown or absent value fails eq/in and passes neq/not_in. referrer (host, e.g. instagram.com) and query (needs \"key\", the parameter name): eq, neq, in, not_in, contains, starts_with, ends_with, exists. time (ISO timestamp): before, after. weekday (sun..sat, UTC): eq, neq, in, not_in. hour (0-23 UTC): eq, neq, in, not_in, gte, lte. in/not_in take an array. Text compares case-insensitively. Up to 20 rules, 20 conditions per rule. Example app-store split: [{\"name\":\"iOS\",\"when\":{\"field\":\"os\",\"op\":\"eq\",\"value\":\"ios\"},\"targetUrl\":\"https://apps.apple.com/app/id123\"},{\"name\":\"Android\",\"when\":{\"field\":\"os\",\"op\":\"eq\",\"value\":\"android\"},\"targetUrl\":\"https://play.google.com/store/apps/details?id=com.example\"}]"},"linkId":{"type":"string","minLength":1,"description":"The link id (linkId), as returned by create_short_link or list_short_links"},"status":{"enum":["active","paused"],"type":"string"},"payment":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}],"description":"Only for footer: false on a page that has not been paid off, by a self-signed-up tenant: the tool first returns an error whose structuredContent is an x402 PaymentRequired; retry with the signed PaymentPayload in _meta[\"x402/payment\"], or, if your client cannot set _meta, here (an object or base64)."},"qrStyle":{"type":"object","properties":{"dark":{"type":"string","description":"Hex colour, e.g. #000000 (the # is optional)"},"image":{"type":"object","required":["mode"],"properties":{"data":{"type":"string","description":"A new picture, as a data URL"},"mode":{"enum":["logo","halftone"],"type":"string"},"size":{"type":"number"},"imageId":{"type":"string","description":"Keep the picture the link already has (its qrStyle.image.imageId)"}},"description":"A picture in the code. mode \"logo\": in the middle (error correction becomes H; size is its side as a share of the code, 0.1-0.3, default 0.22). mode \"halftone\": a photo behind the code, drawn as dots over it. data is a data URL (data:image/png;base64,... png, jpeg, webp or gif, up to 2 MB). To keep the current picture while changing other fields, pass its imageId instead of data."},"light":{"type":"string","description":"Hex colour, e.g. #000000 (the # is optional)"},"margin":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Quiet zone in modules, 0-16"},"eyeBall":{"enum":["square","rounded","circle"],"type":"string","description":"Centre of the corner markers"},"modules":{"enum":["square","rounded","dot","row","column"],"type":"string","description":"Shape of the data modules (default square)"},"eyeColor":{"type":"string","description":"Colour of the corner markers; defaults to dark"},"eyeFrame":{"enum":["square","rounded","circle"],"type":"string","description":"Outer ring of the three corner markers"},"errorCorrectionLevel":{"enum":["L","M","Q","H"],"type":"string","description":"QR error correction level: L 7%, M 15% (default), Q 25%, H 30%"}},"description":"Default look of this link's QR image (free): colours, module and corner-marker shapes, and an optional picture. Styled codes need dark on light with at least 3:1 contrast. The whole style is replaced on update."},"groupIds":{"type":"array","items":{"type":"string"},"description":"The complete new set of groups; replaces the current one"},"metadata":{"type":"object","description":"Up to 20 string key/value pairs for your own bookkeeping","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"targetUrl":{"type":["string","null"],"description":"New absolute http(s) destination"}}},"annotations":{"idempotentHint":true,"readOnlyHint":false,"destructiveHint":false},"title":"Update short link"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":2170,"tokensAfter":2170}],"toolsChanged":8,"tokensSaved":0,"todo":[{"tool":"preview_link_page","params":["query","source","referrer","userAgent","acceptLanguage"]},{"tool":"test_redirect_rules","params":["userAgent"]},{"tool":"update_short_link","params":["name","page","status"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}