# FynCom MCP MCP

> FynCom MCP connects your AI agent to real-time micro-payment and reward systems. Instantly incentivize users by sending fiat or crypto rewards directly for survey completion, feedback, or lead engagement. Manage entire campaigns and track payouts without leaving your workspace.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** micro-payments, incentives, rewards, user-engagement, survey-completion, fiat-crypto-payments

## Description

Managing user incentives used to mean dealing with complicated spreadsheets, manual payments, and slow follow-up processes. Now, you can handle it all through natural conversation. By connecting this MCP via Vinkius, your AI client becomes a dedicated rewards coordinator. You use plain language commands to send instant crypto or fiat payouts directly to users based on their actions. Need to know how much money you have left? Just ask the wallet balance. Want to start a new campaign? The agent can retrieve all active campaigns and help add leads for automated follow-up payments. This capability cuts out the need for dedicated payment gateways whenever you just need to boost engagement rates with small, reliable incentives.

## Tools

### add_reward_lead
Adds a specific user lead to an existing reward campaign for follow-up.

### get_wallet_balance
Checks your current available balance in the rewards wallet.

### get_campaign_details
Retrieves the full details and parameters of a specified reward campaign.

### list_reward_campaigns
Lists all currently active reward initiatives you've set up.

### list_reward_history
Provides a detailed log of every reward payment that has been sent out.

### send_reward
Sends an incentive or crypto payout to a user address using natural language prompts.

## Prompt Examples

**Prompt:** 
```
List all active reward campaigns in FynCom.
```

**Response:** 
```
I've retrieved your campaigns. You have 3 active initiatives, including 'Beta Tester Rewards' (ID: camp_123) and 'Feedback Incentives' (ID: camp_456). Which one would you like to add a lead to?
```

**Prompt:** 
```
Send a $5 reward to 'user@example.com'.
```

**Response:** 
```
Reward sent successfully! I've delivered the $5.00 incentive to 'user@example.com' (Transaction ID: fyn_992). The user will receive their reward notification shortly.
```

**Prompt:** 
```
Check my FynCom wallet balance.
```

**Response:** 
```
Your current rewards wallet balance is $250.00. You have sufficient funds to cover approximately 50 more rewards of $5.00 each.
```

## Capabilities

### Distribute Instant Rewards
Send cryptocurrency or fiat payouts immediately to specific users or email addresses.

### Track Campaign Status
List and retrieve detailed performance metrics for all currently running reward campaigns.

### Monitor Wallet Funds
Check the current balance of your rewards wallet to ensure you have enough funds for payouts.

### Onboard New Leads
Add specific leads directly into reward workflows, triggering automated follow-up incentives.

### Review Transaction History
View a detailed log of all rewards sent and the associated campaign data.

## Use Cases

### Product Feedback Loop
A product manager needs to incentivize users who submit detailed bug reports. They ask their agent to list active reward campaigns and then use `add_reward_lead` for the new reporter, ensuring they get a payout link immediately.

### Post-Survey Follow-up
After running a major survey, the marketing team needs to pay out rewards. They prompt their agent to check the wallet balance and then use `send_reward` for every qualifying user email address in bulk.

### Campaign Audit
The finance department needs to prove compliance for Q2 incentives. They ask the agent to list reward history, which pulls a full log of all payments made by `list_reward_history`.

### New Lead Qualification
A sales team acquires a new lead from an event. Instead of manual follow-up, they prompt the agent to add the lead using `add_reward_lead`, triggering an immediate incentive email sequence.

## Benefits

- Automatically distribute incentives. Use the `send_reward` tool to pay out crypto or fiat rewards instantly, turning feedback into immediate compensation.
- Keep track of your cash flow. The `get_wallet_balance` function lets you check funds anytime, stopping payments because you forgot how much money you had left.
- Manage campaigns with AI prompts. Instead of navigating multiple dashboards, use the agent to list active reward campaigns or get specific campaign details quickly.
- Nurture leads automatically. Use `add_reward_lead` to enroll new contacts into a payment workflow immediately after they sign up.
- Audit payments instantly. The `list_reward_history` tool provides an easy overview of every single transaction, making compliance checks simple.

## How It Works

The bottom line is: your AI client handles the API calls and displays the results in natural language for you to use right away.

1. Subscribe to this MCP on Vinkius, then grab your API Key from your FynCom dashboard settings.
2. Connect your AI agent (Claude, Cursor, etc.) and tell it what you need. For example, 'List all active campaigns.'
3. The agent runs the necessary function call, pulling real-time data like current balances or sending a reward with confirmation details.

## Frequently Asked Questions

**How do I check my current balance using get_wallet_balance?**
You just ask your agent to run `get_wallet_balance`. It will return the exact, up-to-date number of rewards you have available for immediate use.

**Can I pay multiple users at once with send_reward?**
Yes. You provide a list of recipients and their corresponding reward amounts in your prompt. The agent handles the loop, sending each incentive transactionally.

**What is the difference between listing campaigns and get_campaign_details?**
Running `list_reward_campaigns` shows you a menu of all active initiatives. If you need specifics—like the exact criteria or payout rules for one campaign—you use `get_campaign_details`.

**Do I have to manually add every user using add_reward_lead?**
No, but you can. If a lead comes through an external system that needs immediate tracking, running `add_reward_lead` ensures they are correctly enrolled and eligible for automated incentives.

**How do I find my credentials to start using `list_reward_campaigns`?**
You need an active API Key from your FynCom dashboard. Your AI client uses this key for all interactions, including listing campaigns. Make sure the key has read permissions enabled in your account settings before attempting to list anything.

**If a payment fails when I use `send_reward`, how do I track the error?**
The response from `send_reward` will include an explicit error code and reason. You should cross-reference this failure with `list_reward_history`. This allows you to confirm if a partial payout occurred or if the system flagged a specific user issue.

**What information does `list_reward_history` provide about past payouts?**
`list_reward_history` gives you a full, audit-ready log of every transaction. You specify parameters like date ranges or campaign IDs in the prompt to filter results, keeping your AI agent focused on only the relevant payment data.

**What is the required format for passing data when calling `add_reward_lead`?**
The system expects a JSON object containing the lead's identifier, the target campaign ID, and associated metadata. To ensure you use the correct structure, run `get_campaign_details` first to verify all necessary parameters.

**How do I find my FynCom API Key?**
Log in to your FynCom dashboard and navigate to the **Settings** > **API** section to generate or copy your unique key.

**Can I check my wallet balance via AI?**
Yes! Use the `get_wallet_balance` tool to retrieve your current rewards budget and ensured you have sufficient funds for your campaigns.

**How do I add a lead to a reward campaign?**
Use the `add_reward_lead` tool by providing the `campaign_id` and a JSON string with the lead's email and other required details.