Skip to main content
Glama
October Themes MCP Server

October Themes MCP Server

by october-dev

October Themes MCP

Give any AI-generated interface a real design direction.

1,000+ curated systems for color, type, components, motion, and visual character.

npm MCP License


October Themes MCP is a free Model Context Protocol server for better AI-generated UI. It gives your coding agent a complete, prompt-ready design system before implementation starts: semantic colors, typography, component treatments, effects, motion, and deliberate rules that keep the result from collapsing into generic dashboard styling.

No API key. No theme account. Add the server once and ask your agent for a design direction whenever you need one.

Quickstart

Add the server to your MCP configuration:

{
  "mcpServers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}

Then ask your agent:

Get a desktop-web theme, then use it to build the settings screen.

The agent calls get_theme, receives one complete design system, and uses it as context for the UI it generates.

Related MCP server: io.github.bergside/typeui

Client configuration

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "october-themes": {
      "command": "npx",
      "args": ["-y", "@october-dev/themes-mcp"]
    }
  }
}

Any MCP client that can start a local stdio server can use the same command and arguments.

Available tools

Tool

Input

Result

get_theme

Optional platform filter

A weighted-random, prompt-ready design system

get_theme_by_id

Theme ID or slug

The requested design system

Supported platform filters:

Platform

Designed for

desktop-web

Websites, dashboards, and SaaS applications

mobile-app

iOS and Android interfaces, including navigation and mobile interaction patterns

game

Browser games, including lighting, particles, HUDs, and motion

Omit the platform to draw from the complete theme library.

What a theme contains

Every response is ready to place directly in an agent's context:

  • semantic color palette with concrete values;

  • typography families, sizes, weights, and hierarchy;

  • button, card, input, navigation, and layout treatments;

  • shadows, gradients, transitions, and animation direction;

  • platform-specific interaction guidance;

  • mandatory non-genericness rules that establish a distinct visual point of view.

The server supplies direction, not UI code. Your agent still implements the interface in the framework and component system already used by your project.

How it works

Your request
    ↓
AI client calls get_theme
    ↓
October Themes MCP fetches one curated design system
    ↓
The design system enters the model's working context
    ↓
The agent builds your UI against that direction

The MCP server runs locally over stdio and makes a read-only request to October's public themes API. It does not require credentials and does not read or modify your project files on its own.

Example prompts

Get a mobile-app theme and redesign the onboarding flow around it.
Fetch the industrial-neon theme and apply it to this dashboard without changing its information architecture.
Choose a game theme before implementing the inventory HUD.

For predictable results, ask for the theme before the agent starts producing UI code.

MCP server or Agent Skill?

Use this repository when your client supports MCP and you want the theme library exposed as tools. Use October Themes Skill when your harness supports Agent Skills and you prefer a /inject-theme workflow.

Both use the same curated theme library:

Themes MCP

Themes Skill

Interface

MCP tools

/inject-theme skill

Theme selection

Agent calls a tool

Skill fetches and confirms a theme

Best fit

MCP-native clients

Skill-native harnesses

Development

git clone https://github.com/october-dev/october-mcp.git
cd october-mcp
npm install
npm run build
npm start

Set OCTOBER_API_URL to point development builds at another compatible API origin.

Contributions that improve client setup, error handling, tool descriptions, and protocol compatibility are welcome. Keep the server small: theme curation belongs in the library, while this package should remain a clear MCP bridge.

License

October Themes MCP is licensed under the MIT License.


Curated by October, the AI-native canvas for building apps.

Available Tools

2 tools
get_themeA

Get a curated design system theme to inject into your AI prompt. Returns prompt-ready markdown that makes AI-generated UI look polished and unique instead of generic. Just append the returned content to your system prompt.

Inputs: platform.

get_theme_by_idB

Fetch a specific design system theme by its ID. Returns the full prompt-ready markdown content.

Inputs: id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation4/5

    Both tools return theme content, but get_theme provides a general curated theme whereas get_theme_by_id fetches a specific theme by ID. While they share a similar purpose, the descriptions distinguish them adequately for an agent to choose wisely.

    Naming Consistency5/5

    Both tools follow the consistent verb_noun pattern with the 'get_' prefix, making the naming predictable and easy to understand.

    Tool Count3/5

    With only two tools, the server has minimal functionality. While this might suffice for a very simple use case, it feels thin for a design system theme server, as more tools like listing or searching themes would be expected.

    Completeness2/5

    The tool set lacks listing or discovery functionality. An agent cannot browse available themes or search by name; only retrieval by ID or a single random theme is supported, which is a significant gap.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      A design harness for AI coding agents. Better Design gives an agent design systems, UI and UX principles, icons and UI review: it finds or creates a design system that fits the product and installs its components, explains how sign-up, forms and onboarding should work, and reviews finished screens for readability, accessibility and unclear copy.
      48
      568
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding assistants to generate bespoke design systems by synthesizing OKLCH color palettes, chamfer highlights and spring physics, teaching layout composition grammar, and returning micro-interaction primitives and component blueprints. Also audits JSX/TSX/HTML through a senior design director's lens to score and critique UI quality.
      1 npm
      1
      MIT