Skip to main content

​
get_token

Retrieves detailed information about a specific design token, including its resolved value.

​
Tool Schema

{
  "name": "get_token",
  "description": "Get a specific token by ID with its resolved value",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset"
      },
      "mode_id": {
        "type": "string",
        "description": "The ID of the mode"
      },
      "token_id": {
        "type": "string",
        "description": "The ID of the token to retrieve"
      }
    },
    "required": ["tokenset_id", "mode_id", "token_id"]
  }
}

​
Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset containing the token
mode_idstringYesThe ID of the mode containing the token
token_idstringYesThe ID of the token to retrieve

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440030",
  "name": "color.primary",
  "type": "color",
  "value": "#007AFF",
  "description": "Primary brand color used for main actions and links",
  "alias_to": null,
  "mode_id": "550e8400-e29b-41d4-a716-446655440020",
  "tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
  "created_at": "2025-01-15T13:00:00Z",
  "updated_at": "2025-01-15T13:00:00Z",
  "resolved_value": "#007AFF"
}

​
Example Usage in Claude

​
Get Token Details

You: Get details for token 550e8400-e29b-41d4-a716-446655440030 in Light mode

Claude: Here are the details for that token:

**Token: color.primary**
- **ID**: 550e8400-e29b-41d4-a716-446655440030
- **Type**: color
- **Value**: #007AFF
- **Resolved Value**: #007AFF
- **Description**: Primary brand color used for main actions and links
- **Alias**: None
- **Mode**: Light
- **Tokenset**: Brand Colors

​
Check Token Aliases

You: Does this token reference another token?

Claude: Let me check the token details.

This token (color.secondary) is an alias that references color.primary.
- **Alias To**: color.primary
- **Resolved Value**: #007AFF (inherited from primary)

​
Resolved Values

The resolved_value field shows the actual value that should be used:
  • For direct tokens: resolved_value equals value
  • For aliased tokens: resolved_value is the resolved value from the referenced token
  • For complex tokens: resolved_value may include computed values

​
Common Use Cases

​
1. Token Verification

You: Check the exact value of my primary color token

​
2. Alias Investigation

You: Find out what this aliased token actually resolves to

​
3. Token Documentation

You: Get full details about this spacing token

​
Error Handling

If the token doesn’t exist, you’ll get an error response. Make sure all three IDs (tokenset_id, mode_id, token_id) are valid and the token exists in that specific mode.

​
Notes

  • Tokens are specific to both a tokenset and a mode
  • The same token name can exist in different modes with different values
  • Aliased tokens (alias_to field) reference other tokens by name
  • Use this tool when you need complete information about a specific token

​
See Also