How to Use the Greptile MCP in Windsurf

Q: How does Windsurf use Greptile to search across multiple repositories?

Cascade calls listrepositories to find your target codebase, then runs querycodebase to extract answers. This MCP integration handles the repository selection automatically based on your prompt.

Q: Can I trigger a repository reindex directly from Windsurf using Greptile?

Yes. You can tell Cascade to run reindexrepository when you push major changes. The agent handles the API call and checks the status using getrepositorystatus.

Q: What happens if a repository isn't indexed yet when I query it in Windsurf?

The agent detects the missing index and calls indexrepository to start the process. It will poll getrepositorystatus until the codebase is ready for queries.

Q: How can I monitor my API consumption?

Run a query asking about usage. The agent invokes getgreptileusage to pull your current token and request limits directly into the chat interface.

Let Windsurf Cascade search and map your entire codebase autonomously using the Greptile MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Greptile MCP to Windsurf

Create your Vinkius account to connect Greptile 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 Greptile with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map repository architecture automatically

The `list_repositories` tool retrieves all indexed codebases to let Windsurf plan its next steps. Cascade reads this list, finds the relevant repository, and checks its processing state using `get_repository_status` without waiting for your manual input. Instead of manually pointing your editor to the right files, the MCP Server lets the agent discover the structure on its own. You get an immediate structural overview of any repository in your account right inside your active workspace.

Chain codebase queries in Windsurf

The `query_codebase` tool runs natural language searches across your entire repository to find specific logic blocks. Cascade chains this with `query_with_context` to maintain the state of your debugging session across multiple turns. You ask for a feature implementation plan, and the editor handles the rest. It pulls the necessary context, writes the plan, and shows you the exact files to modify.

Target files with surgical precision

The `search_by_filepath` tool isolates your search to specific files when you already know where the bug lives. Cascade combines this with `get_file_info` to inspect file metadata and locate exact lines of code that need fixes. This targeted approach stops the agent from reading irrelevant files. It keeps token usage low and speeds up the time it takes to generate a working patch.

Setup guide

Set up Greptile 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 Greptile 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 Greptile payment history." If connected, Cascade will call the Greptile tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "greptile-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 Greptile. 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 Greptile 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 Greptile MCP in Windsurf

Cascade calls `list_repositories` to find your target codebase, then runs `query_codebase` to extract answers. This MCP integration handles the repository selection automatically based on your prompt.

Yes. You can tell Cascade to run `reindex_repository` when you push major changes. The agent handles the API call and checks the status using `get_repository_status`.

The agent detects the missing index and calls `index_repository` to start the process. It will poll `get_repository_status` until the codebase is ready for queries.

Run a query asking about usage. The agent invokes `get_greptile_usage` to pull your current token and request limits directly into the chat interface.

Your repository index data is processed using transport-layer security and stored in isolated environments. The MCP Server only accesses the index via secure API tokens, and you can purge any codebase instantly using `delete_repository`.

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