Read

list_social_icons

Returns the global catalog of available social-platform icons (id + name) so agents know which numeric platform IDs to pass to set_social_links.

Parameters

This tool accepts no arguments. The input schema is empty.

Name	Type	Required	Description

Response

Field	Type	What it means
icons	SocialIconItem[]	Ordered array of all available social icon platforms. Each item has `id` (integer, pass to `set_social_links` as `platform`), `name` (display name of the platform, e.g. ‘Instagram’; null if unset), and `order` (admin-defined sort position, lower = first; null if unset).

Example

Request

json

{}

Response

json

{
  "icons": [
    { "id": 1, "name": "Instagram", "order": 1 },
    { "id": 2, "name": "TikTok", "order": 2 },
    { "id": 3, "name": "YouTube", "order": 3 },
    { "id": 4, "name": "LinkedIn", "order": 4 },
    { "id": 5, "name": "Twitter", "order": 5 },
    { "id": 6, "name": "Pinterest", "order": 6 }
  ]
}

When to use

Call this before set_social_links whenever you don't already have the integer platform IDs in context. It is the discovery step that prevents set_social_links failures caused by passing string names or guessed IDs.

Gotchas

Watch out

The id field is the integer you must pass as the platform param to set_social_links — it is NOT a string slug.
This tool accepts no arguments at all; passing any args will be ignored (input schema is empty).
Results are capped at 200 docs; in practice the catalog is small (single digits to low dozens).
Auth is still required — a valid Bearer PAT must be present even though the collection uses overrideAccess:true internally.

← All tools ← MCP Guide