Connect Windsurf
Windsurf (by Codeium) is an AI-native code editor with MCP support. Connect it to Bodha Route Planner to query your fleet data while you work.Time to set up: Under 2 minutes. No install, no dependencies.
Prerequisites
- Windsurf installed
- A Bodha Route Planner API key (generate one here)
Setup
1
Open MCP configuration
In Windsurf, open the Command Palette (
Cmd/Ctrl + Shift + P) and search for “MCP” or “Model Context Protocol”.Alternatively, edit the MCP config file directly:- macOS:
~/.windsurf/mcp.json - Windows:
%APPDATA%\Windsurf\mcp.json - Linux:
~/.config/windsurf/mcp.json
2
Add the Bodha Route Planner server
Add or merge the following into your MCP config:Replace
bdk_live_YOUR_KEY_HERE with your actual API key.3
Restart or reconnect
Save the file and restart Windsurf, or use the MCP panel to reconnect. The server should appear as Connected.
4
Test it
Open Windsurf’s AI chat (Cascade) and type:
“Show me today’s routes from Bodha Route Planner”You should see your route data returned in plain language.
Example questions
Troubleshooting
Server not connecting
Server not connecting
- Verify the JSON is valid — use a JSON validator if needed
- Check the file path is correct for your OS
- Make sure the URL is exactly
https://mcp.bodha.run/mcp - Restart Windsurf after config changes
Next steps
All 14 tools
Full reference for every MCP tool.
Scopes & security
How your data stays protected.