Find Tokens by Type

Find all tokens of a specific type across all your workspaces, tokensets, and modes. This tool is perfect for discovering all tokens of a particular type without needing to know workspace IDs.

Description

This helper tool searches for tokens by type across your entire Tokencraft account. It automatically discovers all workspaces and searches through all tokensets and modes to find tokens of the specified type. No workspace ID required!

Parameters

Parameter	Type	Required	Description
`type`	string	Yes	Token type to search for (color, dimension, fontSize, etc.)

Response

Returns all tokens of the specified type with:

token_type: The type searched for
results: Array of workspaces and tokensets containing matching tokens
total_found: Total number of matching tokens
usage: Instructions on how to use the returned IDs

Example Usage

# Find all dimension tokens
find_tokens_by_type(type: "dimension")

# Find all color tokens
find_tokens_by_type(type: "color")

# Find all fontSize tokens
find_tokens_by_type(type: "fontSize")

Example Response

{
  "token_type": "dimension",
  "results": [
    {
      "workspace": {
        "id": "0afa0a8a-5e59-4ef9-9619-c12ecdad3c1a",
        "name": "My Workspace"
      },
      "tokenset": {
        "id": "164809aa-cbd2-4c5f-ac1a-af6902c29f6e",
        "name": "Core"
      },
      "tokens": [
        {
          "id": "b748db41-1cb0-4e8a-b671-c9eab26bd584",
          "name": "spacing.xs",
          "type": "dimension",
          "value": "4px",
          "description": "Extra small spacing",
          "mode_id": "2edd637b-5088-4c9b-abbc-e431e5816e94",
          "alias_to": null
        },
        {
          "id": "43796993-1d65-4a89-b1a8-e210fec9c8af",
          "name": "spacing.sm",
          "type": "dimension",
          "value": "8px",
          "description": "Small spacing",
          "mode_id": "2edd637b-5088-4c9b-abbc-e431e5816e94",
          "alias_to": null
        }
      ]
    }
  ],
  "total_found": 2,
  "usage": "Use these token IDs and mode IDs in other tools"
}

Use Cases

Type discovery: Find all tokens of a specific type across your account
Type analysis: Analyze all tokens of a particular type
Type management: Manage all tokens of a specific type
Export by type: Export all tokens of a specific type
No workspace knowledge needed: Works without knowing workspace IDs

Supported Token Types

Type	Description	Example Values
`color`	Color values	`#0066CC`, `rgb(0, 102, 204)`
`dimension`	Spacing, sizing	`16px`, `2rem`, `100%`
`fontSize`	Font sizes	`14px`, `1.2rem`
`fontWeight`	Font weights	`400`, `bold`, `600`
`fontFamily`	Font families	`Inter`, `Arial, sans-serif`
`lineHeight`	Line heights	`1.5`, `24px`
`letterSpacing`	Letter spacing	`0.1em`, `1px`
`duration`	Animation durations	`200ms`, `0.3s`
`cubicBezier`	Timing functions	`ease-in-out`, `cubic-bezier(0.4, 0, 0.2, 1)`
`number`	Numeric values	`42`, `3.14`
`string`	String values	`"Hello"`, `"World"`
`boolean`	Boolean values	`true`, `false`

list_resources - Get workspace and tokenset IDs
search_tokens - Search tokens by name or value
get_tokens_by_mode - Get tokens from specific modes
export_tokenset - Export tokensets

Workflow Example

# 1. Find all dimension tokens
find_tokens_by_type(type: "dimension")

# 2. Use the results to update tokens
update_token(
  tokenset_id: "164809aa-cbd2-4c5f-ac1a-af6902c29f6e",
  mode_id: "2edd637b-5088-4c9b-abbc-e431e5816e94",
  token_id: "b748db41-1cb0-4e8a-b671-c9eab26bd584",
  value: "6px"
)

Best Practices

Use exact type names: Use the exact token type names (case sensitive)
Check all results: Review all workspaces and tokensets in results
Use token IDs: Copy exact token IDs for other operations
Combine with other tools: Use with search_tokens for more specific searches

Error Prevention

This tool helps prevent common errors:

❌ Needing to know workspace IDs
❌ Missing tokens in other workspaces
❌ Using wrong token types
✅ Finding all tokens of a type across your account
✅ No workspace ID required

Common Use Cases

“Show me all dimension tokens” → find_tokens_by_type(type: "dimension")
“Find all color tokens” → find_tokens_by_type(type: "color")
“Get all fontSize tokens” → find_tokens_by_type(type: "fontSize")
“List all spacing tokens” → find_tokens_by_type(type: "dimension") then filter by name

​Find Tokens by Type

​Description

​Parameters

​Response

​Example Usage

​Example Response

​Use Cases

​Supported Token Types

​Related Tools

​Workflow Example

​Best Practices

​Error Prevention

​Common Use Cases