How to Use the Betterfly MCP in Windsurf

Q: Can I assign employee rewards using Betterfly in Windsurf?

Yes. You use the assignreward tool to allocate manual recognition bonuses directly from the editor. Cascade chains this with user lookups to ensure the right team member gets credited.

Q: Where do I configure the Betterfly MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. You can also use the Windsurf Cascade settings UI to paste the endpoint and connect instantly.

Q: How do I audit active corporate benefits?

You run listbenefits to get a clean list of active employee perks. Cascade parses this list to help you identify underused coverage or outdated insurance plans.

Let Cascade run your corporate wellness challenges and pull real-time ESG step counts inside the Windsurf editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Betterfly MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Windsurf chain Betterfly team challenges

The `create_challenge` tool initializes team wellness events directly from your Windsurf chat. Cascade reads your current team roster, sets up the activity, and verifies the launch status in a single run. It then chains `list_challenges` to monitor active events and update your internal markdown docs. Cascade handles the planning and execution without making you prompt every single step. This makes running your wellness initiatives via the MCP Server incredibly simple.

Build automated social impact summaries

The `get_impact_stats` tool exposes your company's social donation and ESG metrics to Cascade. This lets your agent pull raw donation figures, compare them to previous quarters, and write clean reports. Cascade uses `list_donations` right after to verify which charities received the funds. You get a finished markdown summary of your team's real-world impact without writing a single API call yourself.

Track aggregate health engagement

The `get_company_metrics` tool fetches aggregate employee well-being statistics directly into your workspace. Connecting this MCP tool lets Cascade analyze these trends to help you spot when team participation dips. By combining this with `list_activities`, the agent maps step counts against active benefits to see which programs actually get used. It gives you a clear picture of team engagement without exposing individual private health logs.

Setup guide

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

mcp_config.json

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

Cascade calls the Betterfly tools to check wellness metrics and launch challenges. It reads the tool definitions, plans the sequence, and executes the calls without requiring manual prompts for each step.

Yes. You use the `assign_reward` tool to allocate manual recognition bonuses directly from the editor. Cascade chains this with user lookups to ensure the right team member gets credited.

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. You can also use the Windsurf Cascade settings UI to paste the endpoint and connect instantly.

You run `list_benefits` to get a clean list of active employee perks. Cascade parses this list to help you identify underused coverage or outdated insurance plans.

The server processes step counts and insurance scopes through an ephemeral sandbox on Vinkius. Your sensitive HR wellness data never persists on our servers, keeping employee health metrics completely isolated.

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