​

MCP Tools Reference

The Tokencraft MCP server provides comprehensive tools for managing design tokens across workspaces, tokensets, modes, and tokens. All tools are organized into the following categories:

​

🏢 Workspace Tools

Manage your design system workspaces.

• list_workspaces - List all workspaces
• get_workspace - Get workspace details
• create_workspace - Create new workspace
• update_workspace - Update workspace
• delete_workspace - Delete workspace

​

📦 Tokenset Tools

Manage tokensets within workspaces.

• list_tokensets - List tokensets in workspace
• get_tokenset - Get tokenset details
• create_tokenset - Create new tokenset
• update_tokenset - Update tokenset
• delete_tokenset - Delete tokenset

​

🎨 Mode Tools

Manage modes within tokensets (light/dark themes, etc.).

• list_modes - List modes in tokenset
• get_mode - Get mode details
• create_mode - Create new mode
• update_mode - Update mode
• delete_mode - Delete mode

​

🏷️ Token Tools

Manage individual design tokens.

• list_tokens_by_tokenset - List tokens across all modes
• list_tokens_by_mode - List tokens in specific mode
• get_token - Get token details
• create_token - Create new token
• update_token - Update token
• delete_token - Delete token

​

📤 Export Tools

Export tokens in various formats for use in your projects.

• export_tokenset - Export complete tokenset
• export_mode - Export specific mode

​

🔍 Helper Tools

Utilities for searching and discovering tokens.

• list_resources - List all resources with IDs
• search_tokens - Search tokens by name/type/value
• get_tokens_by_mode - Get tokens by mode name
• find_tokens_by_type - Find all tokens of specific type

​

Quick Start

1. Start with workspaces: Use list_workspaces to see what you have
2. Explore tokensets: Use list_tokensets to see tokensets in a workspace
3. Find tokens: Use search_tokens or find_tokens_by_type to locate specific tokens
4. Export for use: Use export_tokenset to get tokens in your preferred format

​

Tool Categories

​

Read Operations

Most tools are read-only and help you explore your design tokens:

• list_* tools for browsing
• get_* tools for details
• search_* and find_* tools for discovery

​

Write Operations

Tools that modify your design tokens:

• create_* tools for new resources
• update_* tools for modifications
• delete_* tools for removal

​

Export Operations

Tools for getting tokens in various formats:

• JSON, CSS, iOS, Android formats supported
• Export entire tokensets or specific modes

​

Authentication

All tools require authentication with your Tokencraft API token. Make sure to configure your MCP server with a valid token before use.

​

See Also

• Configuration - How to configure the MCP server
• Configuration - Configuration options
• Examples - Common usage patterns