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. STRATEGIC candidates 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 →