# FanPower (PickUp) MCP

> FanPower (PickUp) gives you full control over interactive sports and esports content. Use this MCP to manage engagement questions, track fan picks in real-time, monitor leaderboards, and pull audience data directly into your workflow via your AI agent.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** fan-engagement, sports-analytics, interactive-content, gamification, audience-participation, esports

## Description

You can connect your FanPower (now PickUp) account through Vinkius and take control of all interactive sports data using natural conversation. Instead of jumping between dashboards to see who's winning or what the buzz is, you simply ask your AI client for the info. You tell it to list every active question, or maybe find out which fans are participating most often. It can pull detailed fan profiles and participation history so you build a clean database from zero-party data. Need to know how many rewards are available? Just ask. Or check out who's winning right now by reading the leaderboard standings. This MCP makes it possible for your agent to handle complex event coordination, monitoring everything from question performance to reward distribution without you needing to write a single API call.

## Tools

### get_event_details
Retrieves detailed information about a specific sporting or esports event.

### get_fan_profile
Pulls the full profile and participation history for an individual fan.

### get_leaderboard
Fetches the current list of fans and their engagement scores on a leaderboard.

### get_me
Verifies your own API user identity and authorized access level with FanPower.

### get_pick_details
Shows the specific details for one fan's answer or prediction (a 'pick').

### get_question
Gets the full setup, rules, and context for a single engagement question.

### get_reward_details
Retrieves all information regarding a specific prize, achievement, or reward available.

### list_events
Lists every sports or esports event that has interactive content set up.

### list_fans
Generates a list of all registered fans and participants connected to the system.

### list_picks
Pulls a general list of fan picks (answers) across various interactive questions.

### list_questions
Lists every active or available fan engagement question for review.

### list_rewards
Shows all the rewards, achievements, and prize structures that can be awarded.

## Prompt Examples

**Prompt:** 
```
List all active engagement questions on FanPower.
```

**Response:** 
```
I've retrieved your active questions. You have 'Who will win the NBA Finals?' (ID: 101) and 'MVP of the Match?' (ID: 102) currently live. Would you like to see the engagement score for any of these?
```

**Prompt:** 
```
Show me the top 5 fans on the leaderboard.
```

**Response:** 
```
Fetching leaderboard... The top 5 fans are 'Fan_123' (Score: 1200), 'SuperFan_99' (Score: 1150), and 'GamerX' (Score: 1100). Shall I retrieve the profile details for any of them?
```

**Prompt:** 
```
List the latest fan picks for the Lakers vs Celtics game.
```

**Response:** 
```
Analyzing picks for the event... I found 50 new picks. 70% of fans predicted a Lakers victory, while 30% went with the Celtics. Would you like to see the individual responses?
```

## Capabilities

### Discover events and content
List all upcoming sports or esports events that have interactive fan engagement tools available.

### Get details on specific questions
Fetch the full configuration and rules for a single, active engagement question.

### Track individual fan activity
List all registered fans and retrieve detailed profiles or track their participation history.

### Monitor audience predictions
Retrieve a list of every single fan pick (answer) for an interactive question to gauge public sentiment.

### Check leaderboard standings and rewards
Get the current scoring board rankings or view details about available achievements and prizes.

## Use Cases

### Post-Game Sentiment Analysis
A sports media publisher wants to know if the fans generally felt the Lakers were better than expected. They ask their agent to use `list_picks` for that specific event, quickly summarizing whether 70% of picks favored one outcome over another.

### Identifying High-Value Fans
An esports team wants to reward their top supporters. They run a query using `get_fan_profile` for the last month's participants, identifying who has submitted the most picks and showing them which rewards they qualify for.

### Pre-Launch Content Planning
A content manager needs to know what interactive questions are available before a new season starts. They call `list_questions` and then use `get_question` on promising ones to check the setup details.

### Verifying Access for Integrations
A developer needs to confirm that their external system has proper permissions to pull data. They execute the `get_me` tool first, confirming their identity and authorized scope before running any other reports.

## Benefits

- Understand audience predictions instantly. Instead of manually checking sheets, you call `list_picks` to see the raw answers fans gave for a question.
- Build your own database using zero-party data. Use `get_fan_profile` or `list_fans` to pull specific fan histories and segment them by participation type.
- Stay updated on campaign status. You can check the current leaderboard standings with `get_leaderboard` without needing a dashboard refresh, keeping your reporting live.
- Manage rewards program data easily. Need to know if a prize is still available? Use `list_rewards` and then `get_reward_details` for confirmation.
- Coordinate content faster. Check what questions are active using `list_questions`, ensuring your next piece of content fits current fan interest.

## How It Works

The bottom line is you talk to your AI client, and it handles all the data retrieval from FanPower for you.

1. First, subscribe to this MCP and provide your FanPower (PickUp) API Key.
2. Then, connect your preferred AI client—like Claude or Cursor—to Vinkius using the credentials.
3. Finally, start asking your agent questions like, 'Show me the top 10 fans on the leaderboard,' and get real-time data back.

## Frequently Asked Questions

**How do I use `list_events` with FanPower (PickUp)?**
You run `list_events` to see which sports or esports events have active interactive content. This gives you the IDs needed for all subsequent detail lookups, like using an ID in `get_event_details`.

**Can I track individual fan activity with `get_fan_profile`?**
Yes. `get_fan_profile` pulls a comprehensive record of that single user's participation history across all connected events and questions.

**What is the difference between `list_picks` and `get_pick_details`?**
`list_picks` gives you a bulk list of answers for many fans. Use `get_pick_details` when you need deep, granular information about one specific answer or prediction.

**Do I need to use `get_me` before running other tools?**
It's best practice. Running `get_me` confirms your API user identity and authorized access levels first, ensuring the agent has permission to pull data on subsequent calls.

**How do I check my current permissions after running `get_me`?**
The `get_me` tool returns your API credentials and authorized scopes. Check the returned payload details to confirm if you have read or write access for specific functions, like reward management or fan data segmentation.

**What happens when I use `list_questions` if there are thousands of records?**
The API supports pagination. If the results exceed a single page limit, you must pass a cursor or page number to fetch all available questions. Be mindful of rate limits and wait 60 seconds before retrying large data pulls.

**How do I link a specific question ID using `get_question` back to an event?**
The `get_question` endpoint includes the associated Event ID within its metadata. You use this returned identifier to cross-reference with the results of `list_events`, ensuring your analysis has perfect contextual linking.

**If I run `get_reward_details` with a non-existent reward ID, what should I expect?**
You will receive a 404 Not Found status code. This means the provided reward ID doesn't match any active record in the system. Always validate IDs by first running `list_rewards` to verify existence.

**How do I obtain my FanPower (PickUp) API Key?**
You can request an API Key from your account manager at PickUp or through their developer portal at wiki.playpickup.com.

**Can I see the results of individual fan predictions?**
Yes! The `list_picks` and `get_pick_details` tools allow you to retrieve individual answers submitted by fans for any interactive content.

**Is it possible to monitor the fan leaderboard?**
Absolutely. Use the `get_leaderboard` tool to see the top-performing fans based on their participation and prediction accuracy.