List client protocol mappers
keycloak_client_mappers_listList protocol mappers aggregated for a client to inspect token shaping. Returns a JSON array of mappers or an error message if client not found.
Instructions
Lists the protocol mappers configured on a single client, aggregated across the client and its assigned scopes. This is a read-only, idempotent operation that does not modify Keycloak. Use it to inspect how tokens issued for the client are shaped; to first find a client's scopes use keycloak_client_default_scopes_get. Returns the protocol mappers as a JSON array, or the text "Client not found." when no client matches the given clientId.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"clientId": "<clientId>"
},
"name": "keycloak_client_mappers_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clientId | Yes | The internal Keycloak UUID of the client (the "id" field, not the human-readable clientId), for example "a1b2c3d4-5678-90ab-cdef-1234567890ab". Required. |