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.
Table of Contents
- Two Pieces, Not One
- Installing Walter Skills in Cursor and Windsurf
- Connecting the Walter MCP Server
- Verifying the Connection
- Installing a Single Skill Instead of All 12
- A Note on waltermcp.com
- Troubleshooting
- Conclusion
- 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's what lets your agent call Walter's humanizer, detector, and keyword-preservation functions for real, rather than just knowing it's supposed to.
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 either Cursor's or Windsurf's integrated terminal. It pulls all 12 Walter Skills from Skills.sh, Vercel's open Skills registry, and installs them for the agent to pick up automatically. This is the same install path listed directly in the walter-skills GitHub repo, which confirms 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 | For |
|---|---|---|
| SK-01 | SEO Content Writer | General SEO content |
| SK-02 | Agency QC Pipeline | Teams running drafts through multiple writers |
| SK-03 | Local SEO Machine | City and service-page templates at scale |
| SK-04 | Content Repurposer | Turning one piece into threads, posts, newsletters |
| SK-05 | E-commerce Engine | Batch product descriptions and listings |
| SK-06 | Newsletter Writer | Weekly newsletter authoring |
| SK-07 | Programmatic SEO | Hundreds of templated pages from a CSV |
| SK-08 | Brand Voice Adapter | Keeping tone consistent across writers |
| SK-09 | Content Refresh | Updating old posts without losing rankings |
| SK-10 | Lead Magnet Writer | Multi-page guides and whitepapers |
| SK-11 | Social Media Manager | Platform-native posts from one source |
| SK-12 | Documentation Writer | Technical docs, code blocks preserved exactly |
If this is your first time using the Skills.sh registry in either editor, restart the editor after the install finishes. Both Cursor and Windsurf read their skill and MCP configuration at launch, so a running session won't always pick up a fresh install automatically.
3. Connecting the Walter MCP Server
This is the piece that actually gives the agent working tools, and it's a standard remote MCP server connection, which both editors support the same general way, just with slightly different config file locations and field names.
Walter's MCP server address is:
mcp-server.walterwrites.ai/mcp
In Cursor, add it to .cursor/mcp.json in your project root, or your global Cursor MCP settings if you want it available across every project:
{
"mcpServers": {
"walter": {
"url": "https://mcp-server.walterwrites.ai/mcp"
}
}
}
You can also add it through the UI directly: open Cursor Settings, go to the MCP section, and add a new server using that same URL. Cursor handles the OAuth handshake automatically if the server requires it.
In Windsurf, the config file lives at ~/.codeium/windsurf/mcp_config.json, and the field name is different, which is the single most common mistake when copying a config between the two editors:
{
"mcpServers": {
"walter": {
"serverUrl": "https://mcp-server.walterwrites.ai/mcp"
}
}
}
Windsurf uses serverUrl, not url. If you copy a working Cursor config straight into Windsurf without changing that field name, the server won't connect, and there's usually no obvious error message pointing you at why.
A quick honest note here: this MCP server address and the Claude-specific setup instructions (Claude → Settings → Connectors) are confirmed directly from Walter's own ecosystem. The Cursor and Windsurf config shown above follows the standard, documented way both editors connect to any remote MCP server, applied to Walter's address specifically. If it doesn't connect on the first try, check docs.walterwrites.ai for the most current setup steps before assuming your config is wrong.
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:
Humanize this sentence and show me the detection score 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 should actually call Walter's tools and come back with a rewritten sentence plus real before-and-after scores, not just a rewritten sentence with no scoring attached. If it only rewrites without scoring anything, the Skills are loaded but the MCP connector isn't, which is exactly the two-pieces problem from the first section.
In Cursor, you can also check connection status directly under Settings > Tools & MCP. In Windsurf, the MCP panel in Cascade shows connection status for each configured server.
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 of the skill slugs from the table above (walter-seo-writer, walter-agency-qc, walter-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, a community-run guide, not an official Walter Writes AI site. It's a genuinely useful resource, with a library of 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: at the time of writing, waltermcp.com's own FAQ states Walter currently only supports English, with other languages on the roadmap, while Walter's official product pages describe support for dozens of languages across its humanizer and detector. 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. Use waltermcp.com for the prompt ideas and workflow inspiration, but check Walter's own docs 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. This is almost always the two-pieces issue from section one. Confirm the Skills actually installed with npx skills add walterwritesai/walter-skills and that the MCP server shows as connected in your editor's settings, not just one or the other.
Windsurf won't connect even though the same config works in Cursor. Check the field name first. url works in Cursor, Windsurf needs serverUrl. This single difference causes most cross-editor config failures.
Skills don't show up after installing. Restart the editor. Both Cursor and Windsurf load skill and MCP configuration at launch, not while a session is already running.
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.
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 before anything works end to end. Get the connector and the Skills running together, and Cursor or Windsurf 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 regardless of which editor you run it in.
Why didn't my Windsurf config work when I copied it from Cursor?
Check the field name. Cursor uses url for a remote MCP server, Windsurf uses serverUrl. Copying a Cursor config into Windsurf without updating that field is the most common reason a connection silently fails.
Is waltermcp.com the official place to set up Walter's MCP connector?
No, it's a community-run guide, not run by Walter Writes AI. 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 <skill-slug>, using the slug for whichever skill you need.
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.
Top comments (0)