Content
# October Themes MCP Server
An MCP server that injects curated design system themes into AI-generated UI. Works with Claude, ChatGPT, Cursor, VS Code Copilot, Windsurf, and any tool that supports the Model Context Protocol.
**Stop getting generic-looking AI UI.** This server gives your AI coding tool access to 1000+ handcrafted design systems — color palettes, typography, component styles, animations, and bold design rules — so every generated interface has a distinct, polished aesthetic.
## Quick Start
Add to your AI tool — no API key needed, completely free.
**Claude Desktop / Claude Code** — add to `~/.claude/mcp.json`:
```json
{
"mcpServers": {
"october-themes": {
"command": "npx",
"args": ["-y", "@october-dev/themes-mcp"]
}
}
}
```
**Cursor** — add to `.cursor/mcp.json` in your project:
```json
{
"mcpServers": {
"october-themes": {
"command": "npx",
"args": ["-y", "@october-dev/themes-mcp"]
}
}
}
```
**VS Code Copilot** — add to `.vscode/mcp.json`:
```json
{
"servers": {
"october-themes": {
"command": "npx",
"args": ["-y", "@october-dev/themes-mcp"]
}
}
}
```
**Windsurf** — add to `~/.windsurf/mcp.json`:
```json
{
"mcpServers": {
"october-themes": {
"command": "npx",
"args": ["-y", "@october-dev/themes-mcp"]
}
}
}
```
### Use it
Just ask your AI:
- *"Get me a theme for this website"*
- *"Inject a mobile app theme and build the settings screen"*
The AI will call the MCP tools automatically.
## Tools
| Tool | Description |
|------|-------------|
| `get_theme` | Get a weighted-random design system theme, optionally filtered by platform (desktop-web, mobile-app, game). Returns prompt-ready markdown. |
| `get_theme_by_id` | Fetch a specific theme by its ID/slug. |
## How It Works
1. You ask your AI to build UI
2. The AI calls `get_theme` to get a design system
3. The theme (colors, typography, spacing, component styles, animations) becomes part of the AI's context
4. All generated UI follows that design system — no more generic Bootstrap-looking output
Themes are curated by the [October](https://october.dev) team — the AI-native canvas for building apps. Each theme includes:
- Complete color palette (8+ semantic colors with hex values)
- Typography system (fonts, sizes, weights)
- Component styles (buttons, cards, inputs with real Tailwind classes)
- Effects & animations (shadows, gradients, transitions)
- Non-Genericness Rules — mandatory bold design choices that prevent bland output
## Platforms
- **desktop-web** — Websites, dashboards, SaaS apps
- **mobile-app** — iOS/Android apps (includes navigation, safe areas, haptics)
- **game** — Browser games (includes lighting, particles, HUD styling)
## License
MIT
---
Built by [October](https://october.dev) — the AI-native canvas for building apps.
