​

MCP Tools Reference

​

📥 Import Tools

• bulk_import — Import collections JSON into a workspace (creates tokensets, modes, and tokens). Requires write:tokens scope.

​

bulk_import format

{
  "workspace_id": "your-workspace-id",
  "collections": {
    "Colors": {
      "Light": {
        "color": {
          "colors.primary": { "value": "#3b82f6", "type": "color" },
          "colors.secondary": { "value": "{colors.primary}", "type": "color" }
        }
      },
      "Dark": {
        "color": {
          "colors.primary": { "value": "#60a5fa", "type": "color" }
        }
      }
    }
  }
}

​

🏢 Workspace Tools

• 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

• 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

• 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

• 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_tokenset - Export complete tokenset
• export_mode - Export specific mode

​

Quick Start

1. Connect: Use OAuth — add https://app.tokencraft.dev/api/mcp in your MCP client
2. Start with workspaces: Use list_workspaces to see what you have
3. Explore tokensets: Use list_tokensets to see tokensets in a workspace
4. Bulk import: Use bulk_import to load tokensets from JSON
5. Export for use: Use export_tokenset to get tokens in your preferred format

​

Tool Categories

​

Read Operations

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

​

Write Operations

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

​

Export Operations

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

​

Authentication

​

See Also

• MCP OAuth — authentication flow
• Configuration — connect Cursor, Claude, and more
• Examples — common usage patterns