{
  "markdown": "# uxspot MCP server\n\nThe UX reference your AI assistant can call — and now, the one that draws.\n\n[uxspot.io](https://uxspot.io) is a free, curated UX reference: a 203-term glossary (every term with a plain-English definition and a \"why it matters\"), an AI x UX tools directory, 5 interactive checklists, a 78-topic Learn UX curriculum, and Spot Check, a daily UX vocabulary game. This repository documents the remote [Model Context Protocol](https://modelcontextprotocol.io) server that exposes all of it as callable tools for Claude, Cursor, and any other MCP client.\n\n- **Endpoint:** `https://uxspot.io/mcp` — remote, Streamable HTTP, stateless\n- **Landing page and live demo:** [uxspot.io/mcp-server](https://uxspot.io/mcp-server)\n- **Auth:** none — no key, no account, no rate-limit signup\n- **Privacy:** every tool is read-only over public uxspot.io content. The server never sees your project, files, or account.\n- **Sibling project:** the [uxspot Figma plugin](https://github.com/dockster/uxspot-figma-plugin) — the same reference as a design mentor inside Figma, [live on Figma Community](https://www.figma.com/community/plugin/1667975729954963487).\n\n## Install\n\n**Claude Code**\n\n```sh\nclaude mcp add --transport http uxspot https://uxspot.io/mcp\n```\n\n**Claude Desktop** — Settings → Connectors → Add custom connector, with URL `https://uxspot.io/mcp`.\n\n**Cursor** — add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"uxspot\": { \"url\": \"https://uxspot.io/mcp\" }\n  }\n}\n```\n\n**Gemini app (Spark)** — Settings → Connected apps → add a custom app, and paste `https://uxspot.io/mcp` as the URL (just the URL — the JSON below is Antigravity's format, not Spark's). If a credentials step appears under Advanced, leave it empty; uxspot never asks for a key.\n\n**Gemini (Antigravity)** — the IDE and CLI that replaced Gemini CLI. Add to `~/.gemini/config/mcp_config.json`, then `/mcp` in the CLI to confirm:\n\n```json\n{\n  \"mcpServers\": {\n    \"uxspot\": { \"serverUrl\": \"https://uxspot.io/mcp\" }\n  }\n}\n```\n\nGemini Enterprise is the one Gemini door that stays closed: it requires an admin-registered OAuth connector, and uxspot is keyless by design.\n\n**Any other MCP client** that supports the Streamable HTTP transport: point it at `https://uxspot.io/mcp`.\n\n## Tools\n\n| Tool | Arguments | Returns |\n|---|---|---|\n| `search_glossary` | `query` | Matching UX terms with definitions and source URLs |\n| `define_term` | `term` | One term in full: definition, why it matters, reference numbers, a terminal diagram for spatial concepts, and the source URL |\n| `list_ux_tools` | `category?` | The curated AI x UX tools directory, optionally filtered |\n| `list_checklists` | — | The 5 checklists with topic and item counts |\n| `get_checklist` | `slug` | One checklist in full: every topic and item |\n| `search_curriculum` | `query` | Matching Learn UX topics with HTML and Markdown URLs |\n| `get_curriculum` | — | The full Learn UX syllabus outline |\n| `spot_check` | — | One round of the Spot Check vocabulary game: a term, a definition that may or may not fit, the answer, and the explanation |\n\nEvery answer cites its uxspot.io source URL, so you (and your assistant) can verify it.\n\n## What an answer looks like\n\n`define_term(\"60-30-10\")` returns, verbatim:\n\n```\n**60-30-10 rule**\nA color-proportion guideline borrowed from interior design: roughly 60% of a\nscreen in a dominant, usually neutral color, 30% in a secondary color, and 10%\nin an accent reserved for emphasis — enough color to guide the eye without\ncompeting for it.\n\n**Why it matters** — Screens that feel colorful but calm almost always follow\nsome version of this split. Inverting it — letting the accent become the\nmajority — is why loud interfaces feel loud: when everything asks for\nattention with color, nothing gets it.\n\n**The numbers**\n- 60% — dominant, usually neutral\n- 30% — secondary, supporting surfaces\n- 10% — accent, reserved for emphasis and actions\n\n┌────────────────────────────────────┐\n│                                    │\n│      60% — dominant, neutral       │\n│                                    │\n├─────────────────────────┬──────────┤\n│    30% — secondary      │ 10%      │\n│                         │ accent   │\n└─────────────────────────┴──────────┘\n\nSource: https://uxspot.io/glossary/60-30-10-rule\n```\n\n## The terminal diagrams\n\n37 spatial concepts — proportion, position, hierarchy, flow — answer with hand-drawn box art: the Z-pattern's scan path, the information-architecture tree with its misfiled page, the journey map's emotional dip, the empathy map's quadrants, the modal punched through a dimmed page.\n\nThe set is deliberately bounded. Terms whose specimen needs **color** (contrast ratios, eye-tracking heat), **motion** (skeleton shimmer), or **interaction** (Fitts's law's timer, the Zeigarnik checklist) don't get a worse imitation — they point to their live interactive example on uxspot.io instead. And some things monospace physically cannot show: a kerning diagram in a terminal would be a lie about its own subject, since every glyph is the same width by definition.\n\nEvery diagram is hand-authored, never generated, in [`src/lib/glossaryAscii.ts`](src/lib/glossaryAscii.ts) — inspectable like everything else here, and the file records the full adjudication of what is drawn, what points to a live demo, and why.\n\n## Try it\n\nAsk your assistant things like:\n\n- \"What's the Z-pattern? Draw it.\"\n- \"What's an affordance in UX — and where can I read more?\"\n- \"List AI tools for UX research\"\n- \"Give me the accessibility checklist\"\n- \"Search the curriculum for usability testing\"\n- \"Quiz me on UX vocabulary\" (runs Spot Check, round by round)\n\n## How it is built\n\nThe server is a single Cloudflare Pages Function in front of the static uxspot.io site. Each POST is a complete JSON-RPC exchange (stateless Streamable HTTP — no sessions, no database), and the tools read the same structured data that powers the live site, so responses are always in sync with what is published. The tool descriptions even self-count from the data files, so the numbers above cannot drift.\n\nThe code in [`server/`](server/) and the diagram map in [`src/lib/`](src/lib/) are a read-only mirror of the deployed function, published here for transparency and for MCP directory listings. The source of truth lives in the main uxspot site repository; the data files the function imports (`glossary.json`, `tools.json`, `checklists.json`, `curriculum.ts`) live there too, so this mirror is for reading, not building.\n\n## License\n\nThe server code in this repository is released under the [MIT License](LICENSE). The uxspot.io content the tools serve (definitions, checklists, curriculum) remains © Soufiane Chraibi and is licensed for use via the site and this API, not for bulk redistribution.\n",
  "bytes": 6780,
  "sha": "17a3022332e982378100bb8d209f02297461ba58c66d32e2d02c3b0d1d0a5361",
  "repo_slug": "dockster/uxspot-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dockster_uxspot_mcp_d22d9ac2/readme"
}