How to Use the Bonusly MCP in Windsurf

Q: How do I configure the Bonusly MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings menu in Windsurf to connect the server via the Cascade MCP UI. Once added, click refresh to let Cascade auto-discover the tools.

Q: How does Windsurf handle custom company hashtags from Bonusly?

The agent calls listhashtags or listcompanyvalues to fetch your specific organization's rules. It then automatically maps your code accomplishments to the correct official hashtag before submitting. This guarantees your recognition posts always comply with company policy.

Let Cascade run your entire team recognition workflow in Windsurf by chaining Bonusly actions autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bonusly MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate peer recognition chains in Windsurf

Cascade takes a simple goal like rewarding the top-performing developer and builds a complete execution plan. It checks the leaderboard with `get_leaderboard` and gets the target's profile via `get_user` before sending the points. You don't have to trigger each step manually. Once the details are set, Cascade triggers `give_bonus` with the right company hashtag. It reads your team's context, matches the accomplishment to a core value, and processes the reward in one quick sequence.

Align rewards with active team projects

Keep your rewards relevant by letting your editor connect current code milestones to company values. Cascade pulls the active core values using `list_company_values` and matches them against git logs. It finds the exact team members using `list_users` to ensure the right people get credited. This integration means you never have to leave your workspace to celebrate a release. The agent handles the lookup and issues the points directly through this MCP Server connection.

Analyze reward history on the fly

Cascade can audit your team's recognition patterns without manual searching. It pulls recent activity using `list_bonuses` and matches it against `list_redemptions` to see what rewards are popular. You get a clean summary of team appreciation trends directly in your chat panel. This keeps your team culture visible right where you write code. The agent parses the raw JSON payload and gives you a clear picture of who is helping whom.

Setup guide

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

mcp_config.json

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

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings menu in Windsurf to connect the server via the Cascade MCP UI. Once added, click refresh to let Cascade auto-discover the tools.

No, Cascade will always ask for your explicit confirmation before executing write operations like `give_bonus`. You can review the proposed points, recipient, and hashtag before approving the transaction. It ensures complete control over your company's recognition budget.

The agent calls `list_hashtags` or `list_company_values` to fetch your specific organization's rules. It then automatically maps your code accomplishments to the correct official hashtag before submitting. This guarantees your recognition posts always comply with company policy.

Yes, you can ask Cascade to display the current standings. It runs `get_leaderboard` under the hood and formats the results into a clean markdown table right in your editor sidebar.

Your API token is stored securely in your local Windsurf configuration and never shared with third parties. The server only accesses employee profiles and transaction history via a secure MCP connection. Your company's internal recognition data remains completely isolated 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