{
  "$schema": "https://modelcontextprotocol.io/schemas/server-card.json",
  "serverInfo": {
    "name": "october-themes-mcp",
    "displayName": "October Themes",
    "version": "1.0.0",
    "description": "1000+ curated design-system themes for AI coding tools. Exposes tools to fetch themes as prompt-ready markdown.",
    "homepage": "https://october.dev/themes",
    "repository": "https://github.com/october-dev/october-mcp",
    "license": "MIT",
    "vendor": {
      "name": "October",
      "url": "https://october.dev"
    }
  },
  "transport": {
    "type": "streamable-http",
    "url": "https://october.dev/mcp"
  },
  "alternativeTransports": [
    {
      "type": "stdio",
      "install": {
        "npx": "npx -y @october-dev/themes-mcp",
        "npm": "@october-dev/themes-mcp"
      }
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "get_theme",
        "description": "Return a random design-system theme as prompt-ready markdown. Optionally filter by platform.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "platform": {
              "type": "string",
              "enum": ["desktop-web", "mobile-app", "game"],
              "description": "Optional platform filter."
            }
          }
        }
      },
      {
        "name": "get_theme_by_id",
        "description": "Fetch a specific theme by its slug id.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": { "type": "string", "description": "Theme slug id" }
          },
          "required": ["id"]
        }
      },
      {
        "name": "search_themes",
        "description": "Search themes by name; returns matching theme ids and names.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": { "type": "string", "description": "Name search keyword." },
            "platform": { "type": "string", "enum": ["desktop-web", "mobile-app", "game"] },
            "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 }
          },
          "required": ["query"]
        }
      }
    ]
  },
  "links": {
    "documentation": "https://october.dev/themes",
    "agentReadme":   "https://october.dev/themes.md",
    "apiCatalog":    "https://october.dev/.well-known/api-catalog"
  }
}
