Skip to main content
Glama

adhd-mcp

ADHD-friendly Cursor agent kit: on-demand Q&A, concise replies with status footer, context stats via MCP.

Install

cd your-project
npx adhd-mcp init

Reload MCP in Cursor → new Agent chat.

Related MCP server: fcop-mcp

What init writes

Path

Role

.cursor/rules/adhd.mdc

Output baseline + Q&A gate + coding ladder

.cursor/skills/adhd-qa/

Q&A clarification workflow

.cursor/skills/adhd-output/

Short reply + footer format

.cursor/skills/frontend-design/

Distinctive UI (anti–AI-slop)

.cursor/skills/web-design-guidelines/

Vercel Web Interface Guidelines audit

.cursor/mcp.json

Merges adhd_mcp server

adhd/sessions/

Q&A session logs

MCP tools

  • estimate_context — context % (reported or ~heuristic)

  • format_status_footer — 📊 理解 X% │ 进度 Y% │ ctx ~Z%

  • check_readiness — block code until understanding ≥95%

  • verify_against_requirement — after edits: user wording vs coding ladder

  • qa_session_start / qa_session_append — session files

v1 scope

✅ Rule + Skills + MCP + init
❌ GitHub search (v2) · hitl integration

Dev

npm install
npm run smoke
npm run local-test
node dist/index.js init --cwd /path/to/project --force --local

After publish, users run npx adhd-mcp init (uses npm; no --local).

License

MIT

Available Tools

5 tools
check_readinessA

Returns whether understanding ≥95% — code edits forbidden when ready=false.

Inputs: understanding_pct (required).

estimate_contextB

Estimate or accept reported context window usage %. Call before format_status_footer when IDE ring % is unknown.

Inputs: turn_count, rules_chars, conversation_chars, mcp_overhead_chars, +1 more.

qa_session_appendB

Append one Q&A entry to session file. Ask only ONE question per chat turn.

Inputs: kind (required), content (required), session_path (required), understanding_pct.

qa_session_startB

Create adhd/sessions/YYYY-MM-DD-slug.md when starting Q&A for a task.

Inputs: task_summary (required), slug, workspace.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: context estimation, footer formatting, readiness check, session creation, and session appending. No two tools could be confused for one another.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (estimate_context, format_status_footer, check_readiness, qa_session_start, qa_session_append). Perfectly predictable.

    Tool Count5/5

    Five tools is well-scoped for this niche server. Each tool earns its place and covers a specific step in the workflow without redundancy.

    Completeness5/5

    The surface fully covers the intended domain: context awareness, mandatory formatting, readiness gating, and Q&A session lifecycle. No obvious gaps for the stated purpose.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Cognitive prosthetic for AI agents. Indexes conversation history from ChatGPT, Claude Code, Cursor, and Gemini CLI into searchable embeddings. 25 MCP tools including tunnel_state (resume where you left off), switching_cost (quantify context-switch penalty), thinking_trajectory (track idea evolution), and alignment_check (decisions vs principles). LanceDB + Parquet, 12ms recall, local-first.
      25
      179 PyPI
      81
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      File-based multi-agent coordination with persistent tasks, reports, issues and reviews. FCoP 4.0.5 provides 25 canonical MCP tools and 6 read-only resources over local stdio. Work stays in your project as Markdown records, with task lifecycle validation and branch workflows. Includes a Python API and a CLI for setup, inspection and diagnostics.
      25
      64 PyPI
      3
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Professional local context management and system diagnostic tools for AI IDEs (Cursor, Trae, Antigravity, Windsurf).
      36
      84 npm
      1
      MIT