> ## 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.

# Tools Reference

> Complete reference of all available MCP tools for managing design tokens

# MCP Tools Reference

The Tokencraft hosted MCP server provides **24 tools** for managing design tokens.

## 📥 Import Tools

Bulk import tokensets, modes, and tokens in a single operation.

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

### `bulk_import` format

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

Returns a summary: `tokensets_created`, `modes_created`, `tokens_created`, and the list of created tokensets.

## 🏢 Workspace Tools

Manage your design system workspaces.

* **[list\_workspaces](/mcp/tools/list-workspaces)** - List all workspaces
* **[get\_workspace](/mcp/tools/get-workspace)** - Get workspace details
* **[create\_workspace](/mcp/tools/create-workspace)** - Create new workspace
* **[update\_workspace](/mcp/tools/update-workspace)** - Update workspace
* **[delete\_workspace](/mcp/tools/delete-workspace)** - Delete workspace

## 📦 Tokenset Tools

Manage tokensets within workspaces.

* **[list\_tokensets](/mcp/tools/list-tokensets)** - List tokensets in workspace
* **[get\_tokenset](/mcp/tools/get-tokenset)** - Get tokenset details
* **[create\_tokenset](/mcp/tools/create-tokenset)** - Create new tokenset
* **[update\_tokenset](/mcp/tools/update-tokenset)** - Update tokenset
* **[delete\_tokenset](/mcp/tools/delete-tokenset)** - Delete tokenset

## 🎨 Mode Tools

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

* **[list\_modes](/mcp/tools/list-modes)** - List modes in tokenset
* **[get\_mode](/mcp/tools/get-mode)** - Get mode details
* **[create\_mode](/mcp/tools/create-mode)** - Create new mode
* **[update\_mode](/mcp/tools/update-mode)** - Update mode
* **[delete\_mode](/mcp/tools/delete-mode)** - Delete mode

## 🏷️ Token Tools

Manage individual design tokens.

* **[list\_tokens\_by\_tokenset](/mcp/tools/list-tokens-by-tokenset)** - List tokens across all modes
* **[list\_tokens\_by\_mode](/mcp/tools/list-tokens-by-mode)** - List tokens in specific mode
* **[get\_token](/mcp/tools/get-token)** - Get token details
* **[create\_token](/mcp/tools/create-token)** - Create new token
* **[update\_token](/mcp/tools/update-token)** - Update token
* **[delete\_token](/mcp/tools/delete-token)** - Delete token

## 📤 Export Tools

Export tokens in various formats for use in your projects.

* **[export\_tokenset](/mcp/tools/export-tokens)** - Export complete tokenset
* **[export\_mode](/mcp/tools/export-mode)** - Export specific mode

## Quick Start

1. **Connect**: Use [OAuth](/mcp/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

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 OAuth via the [hosted MCP server](/mcp/configuration). The client obtains a Bearer token after browser consent.

## See Also

* [MCP OAuth](/mcp/oauth) — authentication flow
* [Configuration](/mcp/configuration) — connect Cursor, Claude, and more
* [Examples](/mcp/examples/basic-usage) — common usage patterns