> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokencraft.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# get_token

> Get a specific token by ID with its resolved value

# get\_token

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

## Tool Schema

```json theme={null}
{
  "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

| Parameter     | Type   | Required | Description                                 |
| ------------- | ------ | -------- | ------------------------------------------- |
| `tokenset_id` | string | Yes      | The ID of the tokenset containing the token |
| `mode_id`     | string | Yes      | The ID of the mode containing the token     |
| `token_id`    | string | Yes      | The ID of the token to retrieve             |

## Response

```json theme={null}
{
  "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

* [list\_tokens\_by\_mode](/mcp/tools/list-tokens-by-mode) - List all tokens in a mode
* [create\_token](/mcp/tools/create-token) - Create a new token
* [update\_token](/mcp/tools/update-token) - Update token information
* [search\_tokens](/mcp/tools/search-tokens) - Find tokens by name or value