How to Use the DictionaryAPI.dev MCP in Windsurf

Q: How do I configure this dictionary MCP server in my environment?

Add the server under the mcpServers block in your /.codeium/windsurf/mcpconfig.json file. Once saved, click the refresh button in your MCP panel to let Cascade discover the lookup tool.

Let Cascade look up English definitions, phonetics, and origins on the fly while you write code in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DictionaryAPI.dev MCP to Windsurf

Create your Vinkius account to connect DictionaryAPI.dev to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup DictionaryAPI.dev with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade auto-verifies terminology inside Windsurf

The `get_word_definition` tool lets Cascade instantly fetch definitions, phonetic details, and word origins directly inside your active workspace. Instead of leaving your editor to check if you are naming a variable or a class correctly, the agent runs the lookup behind the scenes. You specify a linguistic target, and Windsurf chains the lookup into its current coding plan. It uses the output to refactor your code or document your APIs without requiring manual prompt steps from you.

Automated inline documentation with this MCP Server

The `get_word_definition` tool builds documentation files or JSDoc comments containing exact definitions and phonetic guides. Cascade reads your codebase, identifies poorly defined custom terms, and queries the dictionary to insert clear explanations. This automation prevents typos and semantic errors in your technical docs. The agent executes the entire sequence autonomously, updating your markdown files and showing you the completed edits in one go.

Contextual naming checks during refactoring

The `get_word_definition` tool resolves naming ambiguities by checking the semantic origins of complex words. When Cascade suggests a rename, it validates the word's etymology first to ensure your API endpoints match their real-world meanings. This keeps your domain-driven design linguistically accurate. Because Windsurf handles multi-tool MCP chains, it pulls the definition, validates the context, and applies the code changes across your entire project.

Setup guide

Set up DictionaryAPI.dev MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the DictionaryAPI.dev MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my DictionaryAPI.dev payment history." If connected, Cascade will call the DictionaryAPI.dev tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "dictionaryapidev-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by DictionaryAPI.dev. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect DictionaryAPI.dev now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about DictionaryAPI.dev MCP in Windsurf

Cascade calls the dictionary server directly when it encounters ambiguous terms in your files. It pulls definitions to rewrite confusing comments, keeping your codebase clear for other developers.

Yes, because Cascade chains actions autonomously. You simply ask it to clean up your project's terminology, and it executes the lookup tool on its own.

The agent receives an error code and halts that specific lookup step. It then falls back to your local context to continue the remaining tasks in its plan.

Add the server under the `mcpServers` block in your `~/.codeium/windsurf/mcp_config.json` file. Once saved, click the refresh button in your MCP panel to let Cascade discover the lookup tool.

No, only the specific English words you explicitly look up are transmitted to the external API. Vinkius processes these text queries inside a secure, ephemeral MCP sandbox, ensuring your broader workspace files remain completely untouched and private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript