# Betterfly MCP MCP > Betterfly connects your corporate wellness data and social impact metrics directly into your chat agent. Track global steps, aggregate company donations, and manage employee rewards all in one place. Use this MCP to automate ESG reporting and track internal health engagement without leaving your conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** esg, wellness-programs, corporate-social-responsibility, health-tracking, gamification ## Description Your AI client can pull complex corporate information that used to live across a dozen dashboards. This MCP lets you ask questions about your workforce's well-being and environmental impact using natural language. You can check how many total steps the company has logged, or see exactly what kind of benefits are available through the policy. It even calculates and pulls macro-reports on charitable donations generated by employee activity. When integrated via Vinkius, your agent handles all the complex API calls. Instead of running separate reports in a dedicated dashboard, you just ask: 'What was our total donation impact this quarter?' The system retrieves the data and delivers it right into your chat window. This means HR leaders get instant insights on wellness policy effectiveness, and ESG managers have verifiable proof of corporate social responsibility without lifting a finger. ## Tools ### assign_reward Manually gives an employee a recognition bonus. ### create_challenge Sets up a new team activity challenge for the company. ### get_company_metrics Retrieves overall statistics about employee well-being across the entire organization. ### get_impact_stats Measures and reports on ESG metrics, such as total social donations or environmental achievements. ### get_user_rewards Shows what rewards an individual user has currently unlocked or earned. ### get_user Fetches specific wellness details for a single employee user. ### list_activities Retrieves a history of global corporate steps taken, or specific activities for one person. ### list_benefits Lists all the sub-benefits available under the company's insurance policy. ### list_challenges Provides a list of corporate challenges that are currently active or running. ### list_donations Lists records of charitable donations made by the company workforce. ### list_insurance Fetches a list of covered scopes and policy details. ### list_partners Shows information about linked external ecosystem partners. ### list_users Retrieves a directory listing of all corporate members or users. ### pause_user Temporarily restricts access to a specific user account. ## Prompt Examples **Prompt:** ``` Review the company-wide metrics and highlight our total generated ESG impact via Betterfly. ``` **Response:** ``` Extracted! Your company has translated a stunning 20,400,000 recorded steps into $5,230 USD directed evenly towards clean water foundations globally. Total engagement rate maintains 84% weekly usage. ``` **Prompt:** ``` Check the available balance and internal unlocked perks for user ID 40x889a. ``` **Response:** ``` Inspecting node 40x889a. This user currently maintains 340 Bettercoins and their life insurance policy has safely scaled dynamically to cover +120k coverage scope. ``` **Prompt:** ``` What rewards are officially active for redemption locally today? ``` **Response:** ``` Querying local incentives... You've got an active 'Starbucks Reserve' reward node requiring 500 coins, and an internal 'Company Extra Custom Day Off' tier requiring an incredible 12,000 accumulated coins to ignite. ``` ## Capabilities ### Calculate Total Company Wellness Scores Retrieves aggregate data points about the entire workforce's overall health engagement metrics. ### Generate ESG Impact Reports Measures and reports on social metrics, like total donations or community contributions, derived from employee activity. ### Check Individual User Status Provides specific details about an employee's current wellness standing, coin balance, or participation rate. ### Manage Internal Rewards and Challenges Allows for the creation of new corporate activity challenges or the manual awarding of recognition bonuses. ### List Policy Benefits Pulls a dynamic list of all accessible sub-benefits included in the company's overall policy coverage. ## Use Cases ### Calculating Q3 Social Impact The Sustainability Manager needs total verifiable donations for the board meeting. Instead of downloading reports from three different departments, they ask their agent to run get_impact_stats() and receive a single, comprehensive figure instantly. ### Identifying Policy Gaps The HR Director needs to know what benefits exist for remote workers. They use list_benefits() to pull the full scope of available perks right into their chat thread, eliminating hours of email follow-ups. ### Motivating Participation The Internal Comms team wants to boost step counts. They ask the agent to use create_challenge() and deploy a new 'Summer Step Race' across all company users, generating immediate buzz. ### Investigating User Status A manager needs to know if an employee is engaged. They run get_user(ID) to check the user's current wellness details and Bettercoins balance in seconds. ## Benefits - Instantly check overall company health metrics. You can call get_company_metrics() to see aggregate well-being stats without opening a single dashboard tab. - Prove your social commitment easily. Using get_impact_stats(), you pull macro-reports detailing charitable donations globally, making ESG reporting simple and auditable. - Understand employee incentives. With get_user_rewards(), you quickly determine what rewards an individual user has earned or if they've hit a milestone requiring action. - Manage workforce engagement. If you need to boost participation, you can use create_challenge() to initialize a new team activity challenge instantly via your agent. - Navigate complex policies. list_benefits() pulls all active sub-benefits from the corporate policy, so you don't have to hunt through PDF manuals. ## How It Works The bottom line is that you talk to your agent like a person, but it accesses corporate metrics like they're live API endpoints. 1. First, subscribe to this MCP and provide your secure Betterfly Operator API Key. 2. Next, invoke a tool through your agent—for example, requesting the total corporate steps recorded since January 1st. 3. Finally, the MCP runs the query, formats the data (like total coins or donation amounts), and gives you a clear answer in your chat. ## Frequently Asked Questions **How do I check total ESG impact using get_impact_stats()?** You ask your agent to run get_impact_stats(). It consolidates data points like charitable donations and environmental milestones into a single report for you. **What does list_users tell me?** list_users() gives you a clean directory of all corporate members. This helps you verify which individuals are part of the system before running user-specific queries. **Can I create new wellness activities with create_challenge()?** Yes, use create_challenge() to set up a structured team activity challenge for the company. This generates an official record that teams can participate in and track progress against. **What is the difference between get_user() and list_users()?** list_users() gives you a full roster of every member. get_user(ID) takes one specific user's ID and pulls only their detailed, personal wellness metrics. **When I use `pause_user`, how does the system temporarily restrict an account?** The user's activity is immediately suspended within the Betterfly ecosystem. The MCP returns a status flag indicating restricted access, preventing any further data submissions or actions until manually reactivated. **When I call `list_insurance`, what scopes of coverage are returned for a policy?** The function provides detailed scope information, including the effective dates, maximum coverage amounts, and specific categories like dental or vision. It gives you a precise breakdown of what's covered under the corporate plan. **How does `get_user_rewards` differentiate between an unlocked and a pending reward?** It returns two distinct status fields: 'unlocked' for items the user has earned, and 'pending' for rewards that require additional activity or time before redemption is granted. **Using `list_partners`, what criteria define an 'evaluated' linked ecosystem partner?** An evaluated partner must have a documented API connection to Betterfly. This allows your agent to access real-time data and assess the operational link between that external entity and your internal wellness program. **Can I use the agent to modify a user's Bettercoin balance artificially?** No, this integration functions through strict read-only analytical endpoints aimed directly at corporate administrators, ESG managers, and HR querying metrics. It lacks underlying permissions to inject fraudulent activity data over any client app. **How can I see if the global challenge is generating ESG donations?** Trigger the `list_donations` command. It bypasses conventional UI overhead and displays real-time statistics concerning social funds allocated using internal coin conversion strategies natively connected to ESG programs. **Can I query a single user's detailed activity logging from last week?** Yes! Use the `list_activities` tool with their specific unique UUID as a custom parameter. It isolates tracking loops to just this singular corporate payload string.