How to Use the Gripr MCP in Windsurf

Q: How do I connect Gripr to Windsurf?

Add this MCP server to your mcpconfig.json file inside the .codeium/windsurf directory. Once saved, click refresh in the MCP panel to see the tools appear.

Q: Can Windsurf use Gripr to automate safety logs?

Yes, Cascade can trigger registerhours and listtasks based on the context it finds in your codebase. It handles the API calls while you focus on the construction site.

Let Cascade handle your site safety audits and labor logs directly inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gripr MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-sync project data in Windsurf

Cascade reads your site requirements and pulls the latest status using `list_projects` and `get_project_details`. It maps your current progress against active safety requirements without you needing to switch tabs. Once the context is clear, Cascade uses `list_tasks` to identify pending safety inspections. It then chains these findings to keep your project dashboard current.

Manage field labor with Gripr tools

Your agent tracks team progress by running `list_registered_hours` to see who is on-site. It verifies these logs against the project schedule to ensure nobody is over-extended. When new hours need logging, Cascade calls `register_hours` automatically. It ensures your documentation matches the actual work performed on the job site.

Streamline HSE forms and site users

Cascade scans your site documentation by invoking `list_forms` to find missing safety reports. It identifies which records are outdated and alerts you to the specific compliance gap. It also uses `list_workspace_users` to see who is authorized to sign off on specific tasks. This ensures your project stays within its safety parameters.

Setup guide

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

mcp_config.json

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

Add this MCP server to your `mcp_config.json` file inside the `.codeium/windsurf` directory. Once saved, click refresh in the MCP panel to see the tools appear.

Yes, Cascade can trigger `register_hours` and `list_tasks` based on the context it finds in your codebase. It handles the API calls while you focus on the construction site.

Windsurf requires an active connection to your Vinkius endpoint to sync data. If you lose signal, the tools will fail until your connection returns.

Vinkius manages your connection via an endpoint token, keeping your API keys out of your local files. Your site-specific credentials never leave the secure V8 sandbox.

The server only touches your workspace project data, including user lists and hourly logs. It never accesses your personal files outside the defined construction scope.

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