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

If you're running content operations through Cursor or Windsurf instead of a browser tab, you've probably already found yourself wanting Walter's humanizer and detector available as tools the agent can actually call, not something you paste text into separately. This guide covers both pieces of that setup: the Skills that tell the agent what to do, and the MCP connector that gives it the tools to actually do it.

Updated October 2026: Windsurf is now Devin Desktop. Cognition renamed it on June 2, 2026, and its MCP config file moved. Section 3 has the current setup for both editors.

Table of Contents

1. Two Pieces, Not One
2. Installing Walter Skills in Cursor and Windsurf
3. Connecting the Walter MCP Server
4. Verifying the Connection
5. Installing a Single Skill Instead of All 12
6. A Note on waltermcp.com
7. Troubleshooting
8. Conclusion
9. FAQs

1. Two Pieces, Not One

This is the single most common point of confusion, and it's worth getting straight before touching a config file.

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. They don't do anything on their own.

Walter MCP is the actual tool connector. It gives your agent three tools:

• walter_humanize rewrites AI-generated text to read naturally, with adjustable rewrite strength. It preserves keywords, named entities, URLs, and document structure, and returns a preservation report.
• walter_detect returns a 0 to 100 score, a verdict (likely human, unclear, or likely AI), and the high-risk spans behind it.
• walter_batch_humanize processes several texts in one run, with shared defaults and per-item overrides.

Straight from the walter-skills repo itself: the skills give the agent instructions, but without the MCP connector, it can follow the prompts and still not be able to perform the humanization or detection steps. You need both pieces for this to actually work end to end, not just one.

2. Installing Walter Skills in Cursor and Windsurf

This part is a single command, and it's the same command regardless of which editor you're using, since both are supported through the same registry.

npx skills add walterwritesai/walter-skills

Run that from your project root, in your editor's integrated terminal. It pulls all 12 Walter Skills from Skills.sh, Vercel's open Skills registry. This is the same install path listed directly in the walter-skills GitHub repo, which lists Claude Code, Cursor, Windsurf, and more than 60 other agents as supported through this route.

Here's what you get with that one command:

Code	Skill	Install name	For
SK-01	SEO Content Writer	walter-seo-writer	Anyone producing SEO content with AI
SK-02	Agency QC Pipeline	walter-agency-qc	Agencies running content through a team of writers
SK-03	Local SEO Machine	walter-local-seo	Local agencies and multi-location businesses
SK-04	Content Repurposer	walter-content-repurposer	Turning one post into many formats
SK-05	E-commerce Product Writer	walter-ecommerce	Product descriptions at scale
SK-06	Newsletter Writer	walter-newsletter-writer	Weekly newsletter content
SK-07	Programmatic SEO	walter-programmatic-seo	Large numbers of templated pages from a CSV
SK-08	Brand Voice Adapter	walter-brand-voice-adapter	Teams and agencies serving multiple clients
SK-09	Content Refresh	walter-content-refresh	Updating old content for new ranking potential
SK-10	Lead Magnet Writer	walter-lead-magnet-writer	Gated B2B content
SK-11	Social Media	walter-social-media	Adapting copy for each platform
SK-12	Docs Writer	walter-docs-writer	Help center articles

In Cursor, skills are discovered automatically from .agents/skills/ or .cursor/skills/ in your project, or ~/.agents/skills/ and ~/.cursor/skills/ at the user level. Cursor's docs say skills are discovered when Cursor starts, so restart it if the skills don't show up right after installing. You can also invoke a skill manually by typing / in Agent chat.

If your editor doesn't pick them up, open the skill's folder in the repo, copy its SKILL.md, and add it to your project's instructions.

3. Connecting the Walter MCP Server

This is the piece that actually gives the agent working tools. It's a standard remote MCP server connection, and the server uses OAuth, so there's no API key to paste anywhere.

Walter's MCP server address is:

https://mcp-server.walterwrites.ai/mcp

Cursor

Add it to .cursor/mcp.json in your project root, or ~/.cursor/mcp.json if you want it available across every project:

{
  "mcpServers": {
    "walter-writes": {
      "url": "https://mcp-server.walterwrites.ai/mcp"
    }
  }
}

Cursor supports OAuth for remote servers, so you'll be asked to sign in to your Walter account the first time it connects. Once it's added, open Customize in Cursor's sidebar to see the server and turn it on or off. If it doesn't connect, open the Output panel and select MCP Logs.

The name walter-writes matches Walter's own documentation, which makes Walter's guides easier to follow later.

Windsurf (now Devin Desktop)

Cognition renamed Windsurf to Devin Desktop on June 2, 2026, through an automatic update. Accounts, plans, extensions, and settings carried over. The original Cascade agent was retired on July 1, 2026, and replaced by Devin Local as the default local agent.

The MCP config file moved with the rename. According to Devin's documentation, it now lives at:

• User level: ~/.config/devin/mcp_config.json on macOS and Linux, or %APPDATA%\devin\mcp_config.json on Windows
• Project level: .devin/mcp_config.json, which you can commit so teammates share the setup

{
  "mcpServers": {
    "walter-writes": {
      "url": "https://mcp-server.walterwrites.ai/mcp"
    }
  }
}

That's the same snippet as Cursor. Older Windsurf guides said Windsurf needed serverUrl instead of url, but Devin's current docs accept url for remote servers, and the Cascade docs say either field works. If you're still on an old Windsurf build that hasn't updated, use serverUrl in ~/.codeium/windsurf/mcp_config.json.

Devin Desktop supports OAuth for remote servers. Devin's CLI docs also describe shortcuts for adding the server and starting the sign-in flow:

devin mcp add walter-writes https://mcp-server.walterwrites.ai/mcp
devin mcp login walter-writes

The MCPs section lists each configured server with a toggle to enable or disable it. On Team and Enterprise plans, an admin may need to allowlist the server first.

4. Verifying the Connection

Once both pieces are in place, restart your editor and try a simple test prompt in a project where the skills are installed:

Use the walter-writes MCP server. Humanize this sentence with walter_humanize and run walter_detect before and after: "In today's rapidly evolving digital landscape, organizations must strategically leverage innovative technologies to optimize operational efficiency."

If the connection is working, the agent calls Walter's tools and comes back with a rewritten sentence plus real before-and-after detection scores, a 0 to 100 score and a verdict for each version. If it only rewrites without scoring anything, the agent paraphrased on its own and the MCP connector isn't connected, which is exactly the two-pieces problem from the first section.

In Cursor, check the server's status under Customize. In Devin Desktop, check the MCPs section.

5. Installing a Single Skill Instead of All 12

If you only need one workflow, the local SEO machine for a multi-location client, say, you don't need to install all 12 at once:

npx skills add walterwritesai/walter-skills --skill walter-local-seo

Swap in any install name from the table above (walter-seo-writer, walter-agency-qc, walter-content-repurposer, and so on) to install just that one.

6. A Note on waltermcp.com

If you go looking for more Walter MCP setup material, you'll likely land on waltermcp.com, which describes itself as an unofficial, community-run guide, not an official Walter Writes AI site. It's a genuinely useful resource, with copy-paste prompts and walkthroughs for the same Skills covered here, but it's worth treating as a secondary reference rather than the source of truth.

As one concrete example of why that distinction matters: as of October 2026, waltermcp.com's FAQ still says Walter currently supports English, with other languages on the roadmap, while Walter's official MCP documentation says its humanizer works across more than 80 languages. That's exactly the kind of gap that can happen when a community resource doesn't get updated at the same pace as the product itself. The site also only covers connector setup for Claude, not Cursor or Devin Desktop. Use waltermcp.com for prompt ideas, and check Walter's own docs at docs.walterwrites.ai for anything you're relying on to be current.

7. Troubleshooting

Server shows as connected but nothing happens when you ask the agent to humanize something. Name the server and tool in your prompt ("use the walter-writes MCP server to run walter_detect"), and confirm the server's toggle is on, not just that it's listed. If the agent rewrites text but never shows a score, Walter MCP isn't actually being called.

It works in Cursor but not in Devin Desktop. Check the file location first. Devin Desktop reads ~/.config/devin/mcp_config.json or .devin/mcp_config.json, not the old ~/.codeium/windsurf/ path. Then check the field name: url works in the current version, and only old Windsurf builds need serverUrl.

The sign-in window never appears. Make sure pop-ups aren't blocked, then reconnect. In Devin, devin mcp login walter-writes restarts the flow.

Skills don't show up after installing. Restart the editor. Cursor discovers skills at startup. If they still don't appear, check that the files landed in .cursor/skills/ or .agents/skills/, or paste the SKILL.md into your project instructions.

JSON config won't save or throws an error. A trailing comma after the last entry in mcpServers is the most common culprit. Validate the file with a JSON linter before saving if you're editing it by hand.

Your team's editor blocks the server. On Team and Enterprise plans, admins can restrict which MCP servers are allowed. Ask your admin to allowlist Walter's server.

8. Conclusion

The actual setup here is short: one terminal command for the Skills, one config entry for the MCP connector, and a restart in between. The part that actually trips people up isn't the technical steps, it's not realizing these are two separate systems that both need to be in place, and following older guides written before Windsurf became Devin Desktop. Get the connector and the Skills running together, and Cursor or Devin Desktop starts drafting, humanizing, and scoring content in the same agent loop you're already using for code.

9. FAQs

Do I need both Walter Skills and Walter MCP, or just one?
Both. Skills give the agent instructions for how to approach a task. The MCP connector gives it the actual tools to humanize and detect. Without the connector, the agent can follow the instructions but can't perform the humanization or detection steps themselves.

Does the same install command work in both Cursor and Windsurf?
Yes. npx skills add walterwritesai/walter-skills installs the same 12 skills through the Skills.sh registry, and the walter-skills repo lists both Cursor and Windsurf as supported agents.

Is Windsurf still called Windsurf?
No. Cognition renamed Windsurf to Devin Desktop on June 2, 2026. Existing settings carried over automatically, and the Cascade agent was replaced by Devin Local on July 1, 2026.

Where is the MCP config file in Devin Desktop?
~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows, or .devin/mcp_config.json in a project. The old ~/.codeium/windsurf/mcp_config.json path is from before the rename.

Should I use url or serverUrl?
Use url. Cursor requires it, and Devin Desktop's current docs accept it, so the same config works in both. Only older Windsurf builds required serverUrl.

Is waltermcp.com the official place to set up Walter's MCP connector?
No, it's a community-run guide that describes itself as unofficial. It's a useful secondary resource for prompts and workflow ideas, but check Walter's own documentation for anything setup-related that needs to be current.

Can I install just one Skill instead of all 12?
Yes, with the --skill flag: npx skills add walterwritesai/walter-skills --skill <install-name>, using the install name from the table, such as walter-local-seo.

What should I test first after setting this up?
A simple before-and-after prompt, asking the agent to humanize a sentence and show the detection score on both versions. If it rewrites the text but never shows a score, the MCP connector isn't actually connected yet, even if the Skills are installed.