Model Context Protocol (MCP)

Use your Tokencraft design tokens with AI assistants through natural language. Connect via OAuth — no API key to paste.

Quick start

Add the MCP server

URL: https://app.tokencraft.dev/api/mcpIn Cursor: Settings → MCP → add remote server with this URL.

Authorize

On first use, your browser opens for OAuth consent. Approve the scopes.

Ask

“Show me my workspaces” or “Bulk import these design tokens”

See Configuration and MCP OAuth for details.

What you can do

Browse & Explore

Navigate workspaces, tokensets, modes, and tokens naturally

Bulk import

Import entire tokensets with modes and tokens in one call

Multi-Format Export

Generate CSS, JSON, iOS Swift, Android XML instantly

CRUD Operations

Create, update, and delete tokens via conversation (with write scope)

Supported clients

Cursor — remote MCP with OAuth
Claude — remote MCP with OAuth
Figma plugin — OAuth via browser
Any MCP client supporting Streamable HTTP + OAuth

Architecture

┌─────────────────┐
│  MCP Client     │
│  (Cursor, etc.) │
└────────┬────────┘
         │ HTTPS + OAuth Bearer
         │
┌────────▼───────────┐
│ Tokencraft         │
│ /api/mcp           │
└────────┬───────────┘
         │ REST API
         │
┌────────▼───────────┐
│ Tokencraft API     │
│ /api/v1            │
└────────────────────┘

Tools (24)

Category	Tools
Workspaces	`list_workspaces`, `get_workspace`, `create_workspace`, `update_workspace`, `delete_workspace`
Tokensets	`list_tokensets`, `get_tokenset`, `create_tokenset`, `update_tokenset`, `delete_tokenset`
Modes	`list_modes`, `get_mode`, `create_mode`, `update_mode`, `delete_mode`
Tokens	`list_tokens_by_tokenset`, `list_tokens_by_mode`, `get_token`, `create_token`, `update_token`, `delete_token`
Export	`export_tokenset`, `export_mode`
Import	`bulk_import`

Complete Tools Reference

Resources

Hosted MCP exposes dynamic tokencraft:// resources:

Resource URI	Description
`tokencraft://workspaces`	All workspaces
`tokencraft://workspace/{id}/tokensets`	Tokensets in a workspace
`tokencraft://tokenset/{id}/tokens`	All tokens with resolved values
`tokencraft://tokenset/{id}/export.json`	JSON export
`tokencraft://tokenset/{id}/export.css`	CSS export

Security

Scoped OAuth consent per application
Revoke access from API Settings
Same rate limits as REST API (100 req/min)

Next Steps

MCP OAuth

OAuth flow and scopes

Configuration

Connect your MCP client

Tools

Tool reference

Examples

Example interactions

​Model Context Protocol (MCP)

​Quick start

​What you can do