# Galxe MCP

> Galxe MCP automates Web3 community operations by connecting your AI agent directly to Galxe's data layer. Use this connector to check quest eligibility, read detailed quest info, track loyalty points on leaderboards, and manage custom credentials programmatically—all through natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** web3, community-growth, quest-platform, leaderboards, credentials

## Description

This connection lets you run complex Web3 campaigns without leaving your chat window. Instead of jumping between multiple dashboards or exporting CSV files just to check who qualifies for a badge, you talk directly to your AI agent. It handles the messy data retrieval itself. You can ask it to verify if an address is eligible for specific quests, pull up detailed metrics on current leaderboards, or even update credential lists instantly. Need to know how many people participated in Quest X? Just ask. When you connect this MCP through Vinkius, your agent becomes a full operations dashboard, giving you the visibility and control needed to manage community growth from one spot.

## Tools

### check_credential_eligibility
Determines if a specific wallet address qualifies for a required community credential.

### check_quest_eligibility
Checks if a given user's wallet meets the requirements to participate in a Galxe quest.

### get_quest
Retrieves all necessary details about any specific Galxe quest by its ID.

### get_space_leaderboard
Gets the current ranking and loyalty points for a defined Galxe space.

### get_starboard_leaderboard
Retrieves social influence scores, specifically tracking rankings from Twitter data.

### mutate_credential_items
Modifies the list of users assigned to a specific API credential set.

## Prompt Examples

**Prompt:** 
```
Get the details for Galxe quest ID 'GCabc123'.
```

**Response:** 
```
I've retrieved the details for quest 'GCabc123'. It is currently 'Active' with 1,250 participants. The space associated is 'Web3 Pioneers'. Would you like to check eligibility for a specific address?
```

**Prompt:** 
```
Check if wallet 0x123... is eligible for quest 'GCxyz789'.
```

**Response:** 
```
Checking eligibility... The address 0x123... is currently eligible for quest 'GCxyz789'. All required credential groups have been satisfied.
```

**Prompt:** 
```
Show me the top 10 users on the leaderboard for space ID 555.
```

**Response:** 
```
Fetching space leaderboard... Here are the top users for Space 555: 1. UserA (5000 pts), 2. UserB (4850 pts), 3. UserC (4700 pts)... Would you like to see more entries?
```

## Capabilities

### Verify user qualification for quests
Checks if a specific wallet address meets all requirements set by a Galxe quest.

### Fetch detailed quest data
Retrieves status updates and participant counts for any defined Galxe quest ID.

### Monitor community leaderboards
Pulls current ranking data, whether based on in-platform loyalty points or external social influence metrics.

### Update user credentials
Programmatically adds, removes, or changes the eligible users assigned to a custom API credential set.

## Use Cases

### Auditing a batch of users for a new feature
A Community Manager needs to know if 50 specific wallets are eligible for the 'Alpha' credential. They can prompt their agent: 'Run `check_credential_eligibility` for this list.' The agent processes the check and returns a clean, filtered report immediately.

### Identifying campaign success metrics
A Growth Lead wants to know which quest is performing best. They ask their agent to run `get_quest` using the Quest ID. The agent provides status updates and participant data in natural language, helping them decide where to allocate marketing budget next.

### Updating access rights post-event
A Web3 Developer has confirmed a list of 20 eligible users who just completed the onboarding. Instead of manually updating user records, they instruct their agent to run `mutate_credential_items`, instantly granting them API credentials.

### Pinpointing social leaders
A marketing team needs to find the most vocal members in a space. They ask the agent to call `get_starboard_leaderboard` for that space, getting immediate insights into who has the highest Twitter influence score.

## Benefits

- Automate eligibility checks: Stop manually checking dashboards. You can use `check_quest_eligibility` or `check_credential_eligibility` to instantly confirm if a wallet qualifies for anything.
- Track social influence and points: Use the dedicated leaderboard functions, including `get_starboard_leaderboard`, to find your top contributors without running separate reports.
- Manage credentials programmatically: When users qualify, run `mutate_credential_items` to update their access rights directly. It's a one-step process instead of an API call.
- Eliminate data silos: Get full quest context and participant counts using `get_quest`, giving you all the necessary details in one conversation with your agent.
- Optimize targeting efforts: By analyzing loyalty points via `get_space_leaderboard`, growth leads can immediately identify high-value targets for campaign optimization.

## How It Works

The bottom line is you use your natural language prompts to execute complex Web3 data queries that used to require multiple clicks and API calls.

1. Subscribe to this MCP and input your Galxe Access Token.
2. Your AI agent receives full read/write access to community metrics and credentials.
3. You ask your agent a question, like 'Who is eligible for the Alpha credential?' or 'What are the top 10 users on the leaderboard?'

## Frequently Asked Questions

**How do I find out if a user can participate in a quest using check_quest_eligibility?**
You ask the agent to use `check_quest_eligibility` and provide the wallet address and the Quest ID. It runs the check immediately and tells you if all required criteria are met.

**Does get_space_leaderboard show points from my website?**
No, `get_space_leaderboard` tracks loyalty points specifically within a defined Galxe space. It monitors activity and engagement metrics inside the platform, not external websites.

**Can I get detailed info on a quest using get_quest?**
Yep. `get_quest` lets you retrieve all the necessary details—like its current status, start date, and associated space—just by providing the Quest ID.

**What is the difference between check_credential_eligibility and get_quest?**
`get_quest` gives you metadata about a quest (status, participants). `check_credential_eligibility` takes that context and verifies if a specific user meets the requirements for a credential.

**How does using `get_starboard_leaderboard` differ from checking points with `get_space_leaderboard`?**
It pulls influence data based on Twitter metrics, not internal loyalty points. While space leaderboards track cumulative engagement within the platform, Starboard specifically ranks users by their external social influence scores.

**What is the workflow when I use `mutate_credential_items`?**
This tool doesn't just check status; it actively updates credential eligibility. You pass a list of user IDs and modify their access rights for specific API credentials, changing their standing directly.

**If I run `get_quest` with an invalid Quest ID, how do I handle the error?**
The system returns a standard resource not found error. Always validate your input IDs before calling `get_quest`. This prevents unnecessary calls and keeps your agent workflow clean.

**Are there any rate limits when running multiple checks using `check_quest_eligibility`?**
Yes, standard API throttling applies. If you need to check eligibility for hundreds of addresses, batching your calls is necessary. Sending too many requests too fast will trigger a limit error.

**Can I check if a specific wallet is eligible for a quest?**
Yes. Use the `check_quest_eligibility` tool by providing the Quest ID and the wallet address. The agent will return the eligibility status and details for that specific user.

**How do I see the top participants in a specific space?**
You can use the `get_space_leaderboard` tool with the Space ID. It retrieves the ranking and loyalty points of users within that Galxe space.

**Can I update the list of users for a custom credential?**
Yes, the `mutate_credential_items` tool allows you to append, remove, or replace wallet addresses for a specific API credential ID.