# Zealy MCP for AI Agents AI Agent Connect > Zealy MCP helps you run your community's gamification and growth efforts from your AI client. You can manage quests, track leaderboards, and reward users without ever opening the Zealy dashboard. It turns your AI into a community manager that handles the busy work of tracking progress and reviewing submissions. ## Overview - **Category:** collaboration - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** community-growth, gamification, web3-marketing, quest-platform, engagement-tools ## Description Imagine you're running a Web3 community and the quest list is growing every day. Instead of jumping back and forth between your chat app and the Zealy dashboard to check who's winning or to reward a top contributor, you can just tell your AI agent to do it. This Connector lets you treat your community data like a conversation. You can ask for the current leaderboard, find a specific user by their Discord handle, or even have your agent review a mountain of quest submissions in seconds. It takes the friction out of community management by making your gamification strategy actionable. Whether you're setting up new sprints or managing referral codes, you're moving from manual data entry to active management. Because Vinkius makes it so easy to plug this into your existing setup, you can start handling these tasks directly from the tools you already use every day. It's about staying in your flow while your agent handles the heavy lifting of community maintenance. ## Tools ### list_secrets See all secrets configured for your community. Use this to manage your API task security. ### check_member Verify if a specific user belongs to your community. This lets your agent gate content or interactions. ### create_quest Build a new quest from scratch. You can use this to quickly launch new community goals. ### create_secret Generate a new community secret for API tasks. This helps secure your integrations. ### create_webhook Set up a new webhook for community events. Use this to sync data with your other tools. ### delete_webhook Remove a webhook you no longer need. This keeps your integrations clean and organized. ### get_community Pull basic info about your Zealy community. It's the quickest way to see your current status. ### get_leaderboard Fetch the all-time or sprint leaderboard. Use this to identify your top contributors. ### get_referral_code Retrieve a specific user's referral code. This helps you track growth and performance. ### get_review Fetch a specific review by its ID. Use this to pull up a single submission for closer inspection. ### get_user Get the full profile of a user by their Zealy ID. This provides the context needed for rewards. ### list_modules See all categories and modules in your community. This helps you organize your gamification structure. ### search_users Find members using their social handles. This is perfect for onboarding new people quickly. ### update_quest Modify an existing quest's details. Use this to fix errors or change quest requirements. ### list_quests See every quest currently live in your community. This gives you a bird's eye view of your content. ### list_reviews See all claimed quests waiting for your approval. This is the core of your moderation workflow. ### list_sprints See all the community sprints you have active. Use this to manage your time-bound goals. ### list_webhooks See all the webhooks you've created. This helps you manage your external data syncs. ### remove_xp Take away XP from a user's profile. Use this to correct errors or manage community behavior. ### review_submission Approve or reject a quest submission. This lets your agent act as a moderator for your tasks. ### update_webhook Change the settings of an existing webhook. Use this to fix broken data connections. ### add_xp Give a user extra XP for their contributions. This is the primary way to reward your community. ### ban_user Remove a user from your community. Use this to manage community safety and rules. ## Prompt Examples **Prompt:** ``` Who are the top 5 people on the leaderboard right now? ``` **Response:** ``` Here are the current top contributors for the active sprint: | Rank | User | XP | Role | |---|---|---|---| | 1 | Alpha_Dev | 5,200 | Founder | | 2 | CryptoQueen | 4,850 | Contributor | | 3 | Web3_Wizard | 4,100 | Contributor | | 4 | BlockRunner | 3,900 | Member | | 5 | EtherExplorer | 3,750 | Member Would you like me to send a reward to any of these users? ``` **Prompt:** ``` Add 300 XP to user 'dev_guy_99' for helping out with the documentation. ``` **Response:** ``` ✅ **Success** I've added 300 XP to **dev_guy_99**. * **New Total:** 1,450 XP * **Reason:** Helping out with the documentation I've logged this transaction in the community records. ``` **Prompt:** ``` Are there any new quest submissions I need to look at? ``` **Response:** ``` You have **12 pending submissions** waiting for review. Here are the most recent ones: * **User: QuestMaster** - Completed 'Intro to Web3' (Pending) * **User: MoonShot** - Completed 'Join the Discord' (Pending) * **User: BitBuddy** - Completed 'Follow on X' (Pending) Would you like me to review and approve these for you? ``` ## Capabilities ### Reward users with XP Manually adjust user progress or points using natural language. ### Manage quest lifecycle Create, update, and list quests or modules to keep your community moving. ### Review submissions Let your AI agent look over and approve or reject completed tasks. ### Track community progress Get real-time leaderboard data and sprint statuses instantly. ### Sync community events Configure webhooks to keep your external tools and databases in line with Zealy. ### Verify memberships Check if a user is actually part of your community before granting access. ## Use Cases ### Clearing a submission backlog A community manager asks their agent to check the latest submissions and approve any that look complete. The agent uses list_reviews and review_submission to clear the queue. ### Onboarding a new member A user shares a Discord handle. The manager asks, "Find this user and see if they're in the community." The agent uses search_users and check_member to verify them. ### Rewarding a viral post A user makes a great video. The manager asks, "Add 500 XP to user 'dev_guy_99' for great content." The agent uses add_xp to reward them instantly. ### Launching a new campaign A marketer wants a new sprint. The agent uses list_sprints and create_quest to set up the new goals and community tasks. ## Benefits - Faster moderation: Use review_submission to clear out hundreds of quest completions in seconds instead of clicking approve dozens of times. - Instant rewards: Give out XP using add_xp the moment a user does something great, keeping engagement high and immediate. - Dynamic questing: Create and update quests with create_quest and update_quest on the fly as your marketing goals change. - Automated syncing: Use create_webhook to push Zealy events into your own database or tools without writing extra code. - Easy member lookup: Find people by their handles using search_users to quickly verify and welcome new community members. - Real-time tracking: Pull the latest stats with get_leaderboard to know exactly who your top contributors are at any moment. ## How It Works The bottom line is you get to manage your entire gamification strategy through a chat interface instead of a browser tab. 1. Subscribe to the Zealy MCP and grab your API key from your community settings. 2. Add the key to your AI client's configuration to link your accounts. 3. Start asking your agent to manage quests, reward users, or pull leaderboard stats. ## Frequently Asked Questions **Can I use Zealy MCP to reward my community?** Yes, the Connector allows your AI agent to add XP to users directly. You can give rewards for specific actions like content creation or community help without leaving your chat. **Does Zealy MCP work with Discord handles?** Yes, you can use the search tool to find members by their social handles. This makes it easy to find and reward people who are active in your Discord. **Can I automate quest reviews?** Yes, your agent can list all pending submissions and process them. This helps you clear out backlogs of completed tasks much faster than manual clicking. **How do I sync Zealy data to my other tools?** You can use the webhook tools to send Zealy events to your own database or external apps. This keeps your marketing and growth data in sync automatically. **Is Zealy MCP good for Web3 projects?** It's specifically designed for Web3 community growth and gamification. It handles the common tasks like questing and rewards that are central to Web3 marketing. **Can I manage multiple sprints?** Yes, you can list and create community sprints easily. This allows you to manage time-bound goals and keep your community focused on current objectives. **Can I manually award XP to a specific user for their contribution?** Yes! You can use the `add_xp` tool by providing the community subdomain, the user's UUID, and the amount of XP along with a label and description for the reward. **How do I find a Zealy user if I only have their Discord ID?** You can use the `search_users` tool. Simply provide the community subdomain and the `discordId` parameter to retrieve the corresponding Zealy profile and UUID. **Is it possible to list all pending quest submissions for review?** Absolutely. Use the `list_reviews` tool to fetch submissions that need attention. You can then use `review_submission` to approve or reject them directly.