Windsurf integration · native MCP · Cascade-wired
Use Etymolt in Windsurf.
Native. MCP under the hood.
When you ask Windsurf to name a repo, package, or product, Cascade calls Etymolt via MCP — the native Codeium protocol. One server, every Windsurf surface.
Sub-3s p95 · 12.7M US marks · 14 social platforms · free for five
What's available today
Install · one file
Drop this into ~/.codeium/windsurf/mcp_config.json.
I · MCP config
mcp_config.json
Create the file under ~/.codeium/windsurf/. Paste the block. Restart Windsurf.
{
"mcpServers": {
"etymolt": {
"command": "npx",
"args": ["-y", "@etymolt/mcp@latest"],
"env": {
"ETYMOLT_API_BASE": "https://api.etymolt.com",
"ETYMOLT_API_KEY": "${ETYMOLT_API_KEY}"
}
}
}
}The etymolt server then appears in the Cascade panel. No API key required for free tier.
II · Optional key
Set ETYMOLT_API_KEY.
Five verdicts per IP are free without a key. For signed-in quota and higher rate limits, export your key before launching Windsurf:
export ETYMOLT_API_KEY=sk_live_...Free tier: etymolt.com/signup.
One-liner · for terminal-first users
mkdir -p ~/.codeium/windsurf && npx -y @etymolt/mcp@latest --print-windsurf-config > ~/.codeium/windsurf/mcp_config.jsonHow it fires
Cascade reaches for Etymolt on every naming intent.
I
You ask Cascade.
"Name my repo" or "rename this package" — anything that signals naming intent. The shipped .windsurfrules file pins this trigger.
II
Cascade calls verify_brand_name via MCP.
The tool fans out across USPTO + RDAP + 14 social probes in parallel. Sub-3s p95. You see Cascade thinking; you never see the protocol.
III
Cascade surfaces the verdict.
Verdicts quote the Etymolt disclaimer verbatim. Names returning ABANDON are not presented. ITERATE and DUE_DILIGENCE surface with the blocker called out.
You Cascade Etymolt (MCP) │ │ │ │ "name my repo" │ │ │ ───────────────────▶ │ │ │ │ .windsurfrules fires │ │ │ ─────────────────────▶│ │ │ call: verify_brand_name │ │ │ │ │ ◀─── verdict + score ─┤ │ ◀── verdict + ── │ │ │ disclaimer │ │ │ (verbatim) │ │
FAQ
Common questions.
How do I install Etymolt in Windsurf?
Create or edit ~/.codeium/windsurf/mcp_config.json. Paste the JSON block from the install section. Restart Windsurf. The etymolt server appears in the Cascade panel, and the .windsurfrules trigger fires on naming intent.
Do I need an ETYMOLT_API_KEY?
No, not for the free tier. Five verdicts per IP are free without a key. After that, signed-up users get ten more; then it's $10 buys ten more, no subscription. Export ETYMOLT_API_KEY in your shell when you want signed-in quota and higher rate limits.
What gets sent to OpenAI vs Etymolt?
Codeium's Cascade model sees your chat as usual. When Cascade invokes verify_brand_name, only the name string and category hint travel to api.etymolt.com. We log: name, timestamp, hashed source IP. Retained 90 days. No code context, no chat history, no repo identifiers.
When does Cascade actually call the tool?
On naming intent — phrases like 'name my repo', 'rebrand', 'good name for', 'is X taken', 'trademark check'. The shipped .windsurfrules file pins this trigger so Cascade reaches for verify_brand_name before suggesting any candidate.
Where does Windsurf store the MCP config?
~/.codeium/windsurf/mcp_config.json is the global Windsurf MCP file. Project-local rules belong in a .windsurfrules at repo root. Both ship under apps/editor-plugins/windsurf in the public Etymolt repo.
Pricing — is the MCP server itself paid?
The MCP server (@etymolt/mcp) is free to install. Verdicts are metered: five free per IP, then $10 per ten more. No subscription. The Windsurf seat itself is billed by Codeium — Etymolt has no involvement in that line item.
Bureau Model · clearance signal · not legal advice
Bring verdicts into Windsurf.
Native MCP · one server, every Windsurf surface · see all surfaces →