{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3z2qau3srutj","handle":"omarchy-mcp","url":"https://wellknown.network/agents/omarchy-mcp","links":{"self":"https://wellknown.network/agents/omarchy-mcp/record.json","html":"https://wellknown.network/agents/omarchy-mcp","markdown":"https://wellknown.network/agents/omarchy-mcp/record.md","api":"https://wellknown.network/api/v1/agents/omarchy-mcp","status":"https://wellknown.network/api/v1/agents/omarchy-mcp/status","claim":"https://wellknown.network/agents/omarchy-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/omarchy-mcp/claim.json","badge":"https://wellknown.network/agents/omarchy-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/omarchy-mcp/history","tools":"https://wellknown.network/api/v1/agents/omarchy-mcp/tools"},"ard":{"identifier":"urn:air::server:omarchy-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"omarchy-mcp","summary":"MCP Server for Omarchy","description":"# Omarchy MCP\n\nA Model Context Protocol (MCP) server for integrating [Omarchy](https://omarchy.sh) desktop environment theme management with AI assistants like Claude.\n\n## Overview\n\nOmarchy MCP enables AI assistants to manage themes in Omarchy - a Linux desktop environment that supports extensive theme customization including color schemes, backgrounds, and UI elements.\n\nWith this MCP server, AI assistants can:\n- List themes with flexible filtering (installed, available, built-in, removable)\n- Query the currently active theme\n- Switch between installed themes\n- Preview theme images before applying them\n- Install new themes from GitHub repositories\n- Remove installed extra themes\n- Rotate background images\n\n## Installation\n\n### From PyPI\n\n```bash\npip install omarchy-mcp\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/ServiceStack/omarchy-mcp.git\ncd omarchy-mcp\npip install -e .\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"omarchy\": {\n      \"description\": \"Manage Omarchy Desktop Themes\",\n      \"command\": \"uvx\",\n      \"args\": [\n        \"omarchy-mcp\"\n      ]\n    }\n  }\n}\n```\n\n### Using in llms .py\n\nOr paste server configuration into [llms .py MCP Servers](https://llmspy.org/docs/extensions/fast_mcp):\n\nName: `omarchy-mcp`\n\n```json\n{\n  \"description\": \"Manage Omarchy Desktop Themes\",\n  \"command\": \"uvx\",\n  \"args\": [\n    \"omarchy-mcp\"\n  ]\n}\n```\n\n### Development Server\n\nFor development, you can run this server using `uv`:\n\n```json\n{\n  \"mcpServers\": {\n    {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--directory\",\n        \"/path/to/ServiceStack/omarchy-mcp\",\n        \"omarchy-mcp\"\n      ]\n    }\n  }\n}\n{\n  \"command\": \"uv\",\n  \"args\": [\n    \"run\",\n    \"--directory\",\n    \"/home/my…","publisher":null,"homepage":"https://github.com/ServiceStack/omarchy-mcp","repository":"https://github.com/ServiceStack/omarchy-mcp","version":"0.0.6","license":"MIT","protocols":["mcp"],"tags":["ai","mcp","omarchy"],"pricing":null,"endpoints":[{"url":"pypi:omarchy-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"omarchy-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:41.069Z","publishedAt":"2026-01-22T14:09:29.834887Z","latestVersion":"0.0.6"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"omarchy-mcp","url":"https://pypi.org/project/omarchy-mcp/","firstSeenAt":"2026-09-10T08:26:19.890Z","fetchedAt":"2026-11-03T20:28:35.980Z","normalizedAt":"2026-11-03T20:28:35.980Z"}]},"firstSeenAt":"2026-09-10T08:26:19.890Z","updatedAt":"2026-11-03T20:29:41.069Z"}