How to add Architect Cert MCP to Windsurf

Adaptive prep for the Claude Certified Architect exam: 390 questions, spaced repetition, guided capstone, zero sycophancy. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 25★ · stdio · no auth

Windsurf config for Architect Cert MCP

npm install -g connectry-architect-mcp

{
  "mcpServers": {
    "architect-cert-mcp": {
      "command": "connectry-architect-mcp",
      "args": []
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Architect Cert MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Architect Cert MCP's tools become available to Cascade.

Before you start

Node.js (npm) for global install of connectry-architect-mcp
An MCP-compatible client (Claude Code, Claude Desktop, or any MCP client)
Best experience requires a client supporting AskUserQuestion, TodoWrite, and Claude Preview

What Architect Cert MCP can do in Windsurf

start_assessment

Begin with 15 diagnostic questions (lessons-first, one at a time) to determine your learning path.

get_practice_question

Get the next adaptive question with clickable A/B/C/D buttons (overdue reviews > weak areas > new material).

submit_answer

Grade your answer deterministically and present interactive follow-up options.

follow_up

Handle post-answer actions: code examples, concept lessons, handouts, reference projects.

get_section_details

Deep dive into a specific task statement with the full concept handout.

get_progress

View overall study progress with mastery percentages per domain.

get_curriculum

Browse all 5 domains and 30 task statements with current mastery levels.

get_weak_areas

Identify topics that need the most work, ranked by weakness.

Security

Runs entirely locally over stdio with no authentication, accounts, cloud, or telemetry. Study progress and config are stored on your machine in ~/.connectry-architect/ (progress.db SQLite in WAL mode and config.json). The dashboard runs on a local HTTP server for Claude Preview.

Architect Cert MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Architect Cert MCP config there under the "mcpServers" key and restart the client.

Is Architect Cert MCP safe to use with Windsurf?

Does it run in the cloud or require an account?

No. Everything runs locally over stdio. There are no accounts, no cloud, and no telemetry — progress is stored on your machine at ~/.connectry-architect/progress.db (SQLite).

How is grading done — does Claude judge my answers?

No LLM is involved in judging correctness. Grading is a pure deterministic function (gradeAnswer), with no partial credit, and the submit_answer tool instructs Claude to relay results verbatim to avoid sycophancy.

What is the npm package name?

connectry-architect-mcp. Install it globally with `npm install -g connectry-architect-mcp`, or add it to Claude Code with `claude mcp add connectry-architect -- connectry-architect-mcp`.

View repo Full Architect Cert MCP page