---
title: sherlink tools
description: The five link_* MCP tools, with their real argument shapes.
---

# sherlink tools

| Tool | What it does |
| --- | --- |
| `link_list` | List all your short links across apps |
| `link_get` | Get one link's details by code, alias, or id |
| `link_set_access` | Change access, password, expiry, or view budget |
| `link_set_alias` | Set or clear a custom vanity alias |
| `link_delete` | Delete a link **and** the page/file it wraps — irreversible |

Every tool accepts an optional `project` (a slug), defaulting to the
calling key's own home project.

## Arguments

`link_list`: no required arguments — returns every link across both
sherpage pages and sherserve objects in the resolved project.

`link_get`, `link_set_access`, `link_set_alias`, and `link_delete` all
take `code_or_id` (required) — a link's generated code, its custom
alias, or its id, accepted interchangeably.

`link_set_access`: `code_or_id` (required); optional `access`,
`password` (`null` clears it), `expires_at` (`null` clears it),
`max_views` (`null` clears it). See [access](/sherlink/access).

`link_set_alias`: `code_or_id` and `alias` (required — pass `alias:
null` to clear an existing one).

`link_delete`: `code_or_id` and `confirm` (required) — `confirm` must
exactly equal `code_or_id`. This deletes the underlying sherpage page
or sherserve object along with the link; see
[short links and aliases](/sherlink/short-links-and-aliases) before
calling it.

## Next

[sherbase](/sherbase).