Skip to main content
Glama

VitalyGPT MCP

A Model Context Protocol (MCP) server that makes Vitaly Friedman's UX insights available as a tool to any LLM.

Vitaly is the founder of Smashing Magazine and one of the most prolific UX educators on the internet. This project collects his insights and serves them as structured, searchable knowledge — so you can reference his thinking directly inside Claude, Cursor, or any MCP-compatible client while designing your next product.

Status: Personal use / early preview. Shared with Vitaly for feedback before wider distribution.


What it does

Four tools, zero setup friction:

Tool

Description

list_topics

See all UX topic areas covered

search_insights

Full-text search across all insights

get_topic

Get all insights for a specific topic

get_random_insight

Random insight for design inspiration

Topics covered: Forms & Inputs · Navigation & IA · Research & Usability Testing · UX Strategy & Metrics · Design Process · Careers & Communication · UI Components & Patterns · AI & Design Tools


Related MCP server: systembridge-mcp

Setup

Requirements: Node.js 18+

Fastest way: ask your AI agent

Paste this into whatever AI coding agent you use — Claude Code, Cursor, Codex, Gemini, all of them:

Read the setup instructions at github.com/setugk/vitalygpt and add its MCP server (npx -y @vitalygpt/mcp) to your own config in whatever way is correct for you.

It'll fetch this page, figure out the right config mechanism for itself, and tell you when to restart.

Manual setup

Prefer to do it yourself? All clients use the same server command — only the config file's location (and sometimes its format) differs. After editing, restart the client so it picks up the change.

Claude Code

Create .mcp.json at the root of the folder/workspace you open in Claude Code (not a subfolder — it won't be discovered otherwise):

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

Restart Claude Code, then confirm with /mcp or by asking "what MCP servers are connected?".

Claude Desktop

Edit claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Same JSON as above (top-level mcpServers key). Restart the app.

Cursor

Create .cursor/mcp.json — either in a project root (project-only) or ~/.cursor/mcp.json (all projects):

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

OpenAI Codex CLI

Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project):

[mcp_servers.vitalygpt]
command = "npx"
args = ["-y", "@vitalygpt/mcp"]

Or via the CLI: codex mcp add vitalygpt -- npx -y @vitalygpt/mcp

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Contributing

Content lives in content/ as plain markdown files — one file per topic. Each insight follows this format:

## Insight Title

One-paragraph summary of the key takeaway.

**Full post:**

The original post content.

**Source:** [LinkedIn](https://linkedin.com/...) · Vitaly Friedman · YYYY-MM-DD
**Tags:** tag1, tag2, tag3

To add a new insight: edit the relevant topic file and submit a PR. No code knowledge required.

Topic files:

  • content/forms-and-inputs.md

  • content/navigation-and-ia.md

  • content/research-and-testing.md

  • content/strategy-and-metrics.md

  • content/process-and-workflow.md

  • content/careers-and-communication.md

  • content/components-and-patterns.md

  • content/ai-and-tools.md


Roadmap

  • Publish to npm as @vitalygpt/mcp

  • Deduplicate near-identical entries

  • Add semantic search (embeddings)

  • Support for contributions from Vitaly directly


Attribution

All insights are sourced from Vitaly Friedman's public LinkedIn posts, with attribution and links to originals. This project is not affiliated with Vitaly or Smashing Magazine.

License

MIT

Available Tools

4 tools
get_random_insightA

Get a random UX insight from Vitaly Friedman. Great for inspiration during design sessions.

Inputs: no named parameters.

get_topicA

Get all UX insights for a specific topic area (e.g. forms, navigation, research).

Inputs: topic (required).

list_topicsA

List all available UX topic areas covered in the knowledge base.

Inputs: no named parameters.

search_insightsA

Search Vitaly Friedman's UX insights by keyword or topic. Returns matching insights with full content.

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: random insight, topic-specific insights, topic listing, and keyword search. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (get_random_insight, get_topic, list_topics, search_insights).

    Tool Count5/5

    With 4 tools, the server is well-scoped for a UX insight knowledge base, covering random retrieval, topic browsing, and search without excess.

    Completeness5/5

    The tools cover the core needs: random inspiration, topic exploration, topic listing, and full-text search. No obvious gaps for the given domain.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.
      42
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that gives LLMs deep knowledge of design systems and tokens, enabling intelligent design evolution, token analysis, and designer-to-developer handoffs.
      37
      18 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A remote MCP server exposing uxspot.io's curated UX glossary, AI tools directory, checklists, and Learn UX curriculum as callable tools. Enables AI assistants to search for UX terms, tools, and checklists via natural language.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for design decisions during a build, providing live UI/animation library docs (via llms.txt) and a curated knowledge base of UX laws and UI conventions. It enables agents to look up real component APIs and apply design best practices, running locally via stdio or hosted on Vercel.
      6 npm
      MIT