Documentation version: 2026-10-23.6
Canonical: https://docs.creator.gg/tools/links_list.md

# links_list

Search and filter this workspace’s short links. Follow nextCursor to complete pagination. Archived paths are never reassigned.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: reads data or returns an account-screen link.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "limit": 20
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "tag": {
      "type": "string",
      "maxLength": 40
    },
    "state": {
      "type": "string",
      "enum": [
        "active",
        "paused",
        "expired",
        "archived"
      ]
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [short-links](https://docs.creator.gg/guides/short-links.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)