Setting Up Walter MCP in Cursor and Windsurf: The Complete Guide

Description and use

After following the step‑by‑step guide, users can integrate Walter’s tools into Cursor or Windsurf, automatically enhancing and scoring content within their existing agent workflow.

Problem

Content creators using Cursor or Windsurf need Walter’s humanizer and detector tools integrated into their agents, but the two required components—Walter Skills and the Walter MCP connector—are often confused or installed separately, preventing end‑to‑end functionality.

Outcome

After following the guide, users can seamlessly integrate Walter’s humanizer and detector into Cursor or Windsurf, enabling automated content enhancement and scoring within their existing agent workflows.

Workflow

• Run npx skills add walterwritesai/walter-skills in the project root to install all 12 Walter Skills.
• Restart Cursor or Windsurf so the editor loads the new skills and MCP configuration.
• Create or edit the MCP config file: for Cursor, add the server to .cursor/mcp.json with "url": "https://mcp-server.walterwrites.ai/mcp"; for Windsurf, edit ~/.codeium/windsurf/mcp_config.json using "serverUrl": "https://mcp-server.walterwrites.ai/mcp".
• Verify the connection by sending a test prompt such as “Humanize this sentence and show me the detection score before and after: …” and confirm the agent returns rewritten text with before‑and‑after scores.
• If only one skill is needed, run npx skills add walterwritesai/walter-skills --skill <skill-slug> replacing <skill-slug> with the desired skill name.
• Troubleshoot common issues: ensure both skills and MCP are installed, check field names (url vs serverUrl), restart the editor after changes, and validate JSON syntax.

Evidence

Walter Skills are markdown instruction files. Once loaded into a project, they tell your agent how to approach a task, when to humanize, when to lock keywords, what format to return.

Source

Walter's MCP server address is: mcp-server.walterwrites.ai/mcp

Source

In Cursor, add it to .cursor/mcp.json in your project root...

Source