How to Use the Betterfly MCP in Cursor

Q: Can Cursor trigger Betterfly reward allocations directly?

Your agent can execute the assignreward tool to allocate manual recognition bonuses. This helps you test reward-triggering logic in your codebase using real API calls.

Q: What Betterfly partnership data can Cursor access?

The listpartners tool evaluates linked ecosystem partners. Your editor can pull this list to generate dynamic partner directories in your internal applications.

Q: Does Cursor let me manage Betterfly user accounts?

You can query members using listusers to get corporate users. If you need to test administrative functions, pauseuser will temporarily restrict a user account right from your IDE.

Build custom HR dashboards in Cursor by connecting the Betterfly MCP Server to inject live wellness metrics directly into your codebase.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build ESG Reporting Features with Cursor

The `get_impact_stats` tool fetches real ESG metrics so you stop faking API responses. Writing a custom internal dashboard usually means waiting until backend access clears. Cursor writes the frontend components using actual corporate data instead of stubs. This MCP integration solves that problem entirely. The same applies to broader organizational health tracking. Your AI client executes `get_company_metrics` and immediately structures the JSON into TypeScript interfaces. You skip the mock data phase entirely.

Integrate Employee Benefit Systems

The `list_benefits` tool pulls external HR perks directly into your custom intranet codebase. Ask your editor to fetch the exact covered scopes and accessible insurance plans. The agent then writes the rendering logic based on the live schema. Handling specific user states requires accurate data structures. Triggering `get_user` gives you real wellness details, while `get_user_rewards` shows earned bonuses. This MCP Server ensures your code maps perfectly to the production API.

Automate Wellness Challenges

The `list_activities` tool feeds live fitness data straight into your new internal company leaderboard. Cursor tracks global corporate steps and an individual's synced activities in real time. It then generates the React components to display those stats. You can even build administrative tools to manage these events. Calling `create_challenge` lets the agent see the required payload for initializing a team activity challenge. Your custom HR portal comes together without reading external API documentation.

Setup guide

Set up Betterfly MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Betterfly MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Betterfly transactions." If the MCP tools are loaded correctly, Cursor will call the Betterfly tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Create an mcp.json file in your project root directory. Add the Betterfly connection details under the mcpServers key. Turn on Agent mode in the chat panel to start calling tools.

Your agent can execute the `assign_reward` tool to allocate manual recognition bonuses. This helps you test reward-triggering logic in your codebase using real API calls.

The `list_partners` tool evaluates linked ecosystem partners. Your editor can pull this list to generate dynamic partner directories in your internal applications.

You can query members using `list_users` to get corporate users. If you need to test administrative functions, `pause_user` will temporarily restrict a user account right from your IDE.

Vinkius routes all requests through an ephemeral, zero-trust environment. Sensitive HR information like manual recognition bonuses and individual wellness details are processed securely. The connection drops immediately after the API call finishes.

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