MCP server

The Identity Forge MCP server gives your coding agent direct access to the kit catalog. The agent can browse kits, search by style or mood, read kit details, and export tokens into the project.

Setup

Add the server to your agent's MCP configuration.

Claude Code / Claude Desktop

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"]
    }
  }
}

Available tools

Once connected, your agent has access to these tools:

Tool	What it does
`list_kits`	List all available design kits
`search_kits`	Search kits by style, mood, use case, or keyword
`get_kit`	Get full details for a specific kit
`get_kit_colors`	Get the color token system for a kit
`get_kit_typography`	Get typography details for a kit
`export_kit`	Export a kit in any format (CSS, Tailwind, DESIGN.md, JSON, etc.)
`install_kit`	Install a kit's tokens into the current project
`get_kit_motifs`	Get the motifs and signature visual elements
`compare_kits`	Compare two kits side by side

Authentication

The MCP server works without authentication for all free kits (69 of 79). To access Pro kits, set your API key:

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"],
      "env": {
        "IDENTITY_FORGE_API_KEY": "your-api-key"
      }
    }
  }
}

Generate an API key at identityforge.io/account.

Usage example

Once your agent is connected, you can ask it directly:

"Browse the Identity Forge kits and find something minimal and warm for a SaaS dashboard. Install the tokens as CSS variables."

The agent will call search_kits, review the results, pick a kit, and call install_kit to write the tokens into your project.