MCP Server Integration
The Model Context Protocol (MCP) enables AI assistants and IDEs to directly interact with Gamopanda APIs. Gamopanda provides a direct hosted MCP endpoint (https://mcp.gamopanda.com/mcp), allowing your AI assistant to execute admin operations (manage members, streaks, challenges, rewards, webhooks, templates) and query data on your behalf.
Overview
Gamopanda exposes a hosted MCP server endpoint at:
Code
You can connect any MCP-compatible AI assistant or IDE (such as Antigravity, Cursor, Claude Desktop, VS Code, or Codex) directly to this endpoint.
Quick Start Configuration
Add Gamopanda to your IDE or AI assistant configuration file (e.g. mcp_config.json or claude_desktop_config.json).
Use your Gamopanda API Key and API Secret to give your AI assistant admin privileges:
Code
You can generate your x-api-key and x-api-secret pair in the Gamopanda dashboard or via the API Key documentation.
How to Configure in Your IDE / AI Assistant
1. Antigravity & Gemini IDE
Edit your local configuration file located at:
- macOS:
~/.gemini/config/mcp_config.json - Windows:
%USERPROFILE%\.gemini\config\mcp_config.json
Add the gamopanda-admin configuration block inside mcpServers:
Code
Antigravity and Gemini IDE use "serverUrl" (instead of "url") for HTTP/SSE endpoints in mcp_config.json.
2. Cursor IDE
- Open Cursor Settings -> Features -> MCP.
- Click + Add New MCP Server.
- Set Type to
sseorhttp. - Enter URL:
https://mcp.gamopanda.com/mcp - Add headers
x-api-keyandx-api-secret.
3. Claude Desktop
Edit claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the gamopanda-admin JSON definition under mcpServers and restart Claude Desktop.
4. Codex CLI / IDE
Edit your local Codex configuration file located at:
- macOS / Linux:
~/.codex/config.json(or~/.codex/mcp.json) - Windows:
%USERPROFILE%\.codex\config.json
Add the gamopanda-admin JSON block inside mcpServers:
Code
Alternatively, run the Codex CLI command:
Code
Complete List of Available MCP Operations
Once connected, your AI assistant receives full access to every Gamopanda API operation as an MCP tool.
1. Member Management
| Tool Name | Operation | Description |
|---|---|---|
listMember | LIST | List end-user members |
createMember | CREATE | Create a new member |
getMember | GET | Retrieve member details by ID |
updateMember | UPDATE | Update member information |
deleteMember | DELETE | Delete a member |
2. Streak Management & Progress
| Tool Name | Operation | Description |
|---|---|---|
listStreak | LIST | List defined streaks |
createStreak | CREATE | Create a new streak rule |
getStreak | GET | Retrieve streak rule details |
updateStreak | UPDATE | Update streak rule settings |
deleteStreak | DELETE | Remove a streak rule |
listStreakProgress | LIST | List member streak progress records |
getStreakProgress | GET | Get streak progress for a member |
listStreakLog | LIST | List member streak activity logs |
createStreakLog | CREATE | Record a new streak completion entry |
getStreakLog | GET | Get specific streak log entry |
3. Challenge Management & Task Progress
| Tool Name | Operation | Description |
|---|---|---|
listChallenge | LIST | List challenges |
createChallenge | CREATE | Create a new challenge |
getChallenge | GET | Retrieve challenge details |
updateChallenge | UPDATE | Update challenge configuration |
deleteChallenge | DELETE | Delete a challenge |
listChallengeLog | LIST | List challenge execution logs |
createChallengeLog | CREATE | Log a challenge completion |
getChallengeLog | GET | Retrieve challenge log details |
listTaskProgress | LIST | List task completion progress |
getTaskProgress | GET | Get task progress for a member |
listChallengeProgress | LIST | List challenge progress records |
getChallengeProgress | GET | Retrieve member challenge progress |
4. Mission Management & Logs
| Tool Name | Operation | Description |
|---|---|---|
listMission | LIST | List missions |
createMission | CREATE | Create a new mission |
getMission | GET | Retrieve mission details |
updateMission | UPDATE | Update mission settings |
deleteMission | DELETE | Delete a mission |
listMissionLog | LIST | List mission logs |
createMissionLog | CREATE | Log a mission activity |
getMissionLog | GET | Get specific mission log |
listMissionProgress | LIST | List mission progress records |
getMissionProgress | GET | Retrieve member mission progress |
5. Milestone Management
| Tool Name | Operation | Description |
|---|---|---|
listMilestone | LIST | List milestones |
createMilestone | CREATE | Create a new milestone |
getMilestone | GET | Get milestone details |
updateMilestone | UPDATE | Update milestone requirements |
deleteMilestone | DELETE | Remove a milestone |
6. Rewards, Coupons & Reward Logs
| Tool Name | Operation | Description |
|---|---|---|
listReward | LIST | List available rewards |
createReward | CREATE | Create a new reward |
getReward | GET | Get reward details |
updateReward | UPDATE | Update reward configuration |
deleteReward | DELETE | Delete a reward |
listCoupon | LIST | List coupon codes |
createCoupon | CREATE | Create a new coupon code |
getCoupon | GET | Retrieve coupon details |
updateCoupon | UPDATE | Update coupon status |
deleteCoupon | DELETE | Remove a coupon code |
listRewardLog | LIST | List reward redemption logs |
getRewardLog | GET | Retrieve reward log details |
updateRewardLog | UPDATE | Update reward log status |
7. Themes, Templates & Floating Widgets
| Tool Name | Operation | Description |
|---|---|---|
listTheme | LIST | List widget themes |
createTheme | CREATE | Create a custom widget theme |
getTheme | GET | Retrieve theme configuration |
updateTheme | UPDATE | Update theme styling |
deleteTheme | DELETE | Delete a widget theme |
listTemplate | LIST | List widget templates |
createTemplate | CREATE | Create a widget template |
getTemplate | GET | Retrieve template details |
updateTemplate | UPDATE | Update widget template |
deleteTemplate | DELETE | Delete a widget template |
listFloatingWidget | LIST | List floating widget instances |
createFloatingWidget | CREATE | Create a floating widget configuration |
getFloatingWidget | GET | Get floating widget settings |
updateFloatingWidget | UPDATE | Update floating widget settings |
deleteFloatingWidget | DELETE | Delete a floating widget configuration |
8. Email Channels & Email Templates
| Tool Name | Operation | Description |
|---|---|---|
listEmailHeader | LIST | List email headers |
createEmailHeader | CREATE | Create an email header |
getEmailHeader | GET | Retrieve email header details |
updateEmailHeader | UPDATE | Update an email header |
deleteEmailHeader | DELETE | Delete an email header |
listEmailFooter | LIST | List email footers |
createEmailFooter | CREATE | Create an email footer |
getEmailFooter | GET | Retrieve email footer details |
updateEmailFooter | UPDATE | Update an email footer |
deleteEmailFooter | DELETE | Delete an email footer |
listEmailTheme | LIST | List email themes |
createEmailTheme | CREATE | Create an email theme |
getEmailTheme | GET | Retrieve email theme details |
updateEmailTheme | UPDATE | Update an email theme |
deleteEmailTheme | DELETE | Delete an email theme |
listEmailTemplate | LIST | List email templates |
createEmailTemplate | CREATE | Create an email template |
getEmailTemplate | GET | Retrieve email template details |
updateEmailTemplate | UPDATE | Update an email template |
deleteEmailTemplate | DELETE | Delete an email template |
listGamopandaEmail | LIST | List Gamopanda email provider settings |
createGamopandaEmail | CREATE | Create Gamopanda email provider setting |
getGamopandaEmail | GET | Retrieve Gamopanda email provider settings |
updateGamopandaEmail | UPDATE | Update Gamopanda email provider settings |
deleteGamopandaEmail | DELETE | Delete Gamopanda email provider settings |
9. Push, SMS & WhatsApp Integrations
| Tool Name | Operation | Description |
|---|---|---|
listFirebaseCloudMessaging | LIST | List Firebase Cloud Messaging configs |
createFirebaseCloudMessaging | CREATE | Create FCM configuration |
getFirebaseCloudMessaging | GET | Get FCM configuration details |
updateFirebaseCloudMessaging | UPDATE | Update FCM configuration |
deleteFirebaseCloudMessaging | DELETE | Delete FCM configuration |
listAwsSms | LIST | List AWS SMS provider configs |
createAwsSms | CREATE | Create AWS SMS provider config |
getAwsSms | GET | Get AWS SMS config details |
updateAwsSms | UPDATE | Update AWS SMS config |
deleteAwsSms | DELETE | Delete AWS SMS config |
listAwsWhatsApp | LIST | List AWS WhatsApp provider configs |
createAwsWhatsApp | CREATE | Create AWS WhatsApp provider config |
getAwsWhatsApp | GET | Get AWS WhatsApp config details |
updateAwsWhatsApp | UPDATE | Update AWS WhatsApp config |
deleteAwsWhatsApp | DELETE | Delete AWS WhatsApp config |
listPushNotificationTemplate | LIST | List Push Notification templates |
createPushNotificationTemplate | CREATE | Create Push Notification template |
getPushNotificationTemplate | GET | Get Push Notification template details |
updatePushNotificationTemplate | UPDATE | Update Push Notification template |
deletePushNotificationTemplate | DELETE | Delete Push Notification template |
listSmsTemplate | LIST | List SMS notification templates |
createSmsTemplate | CREATE | Create SMS notification template |
getSmsTemplate | GET | Get SMS template details |
updateSmsTemplate | UPDATE | Update SMS notification template |
deleteSmsTemplate | DELETE | Delete SMS notification template |
listWhatsAppTemplate | LIST | List WhatsApp notification templates |
createWhatsAppTemplate | CREATE | Create WhatsApp notification template |
getWhatsAppTemplate | GET | Get WhatsApp template details |
updateWhatsAppTemplate | UPDATE | Update WhatsApp notification template |
deleteWhatsAppTemplate | DELETE | Delete WhatsApp notification template |
10. Notifications & Notification Logs
| Tool Name | Operation | Description |
|---|---|---|
listNotification | LIST | List notification dispatch rules |
createNotification | CREATE | Create notification dispatch rule |
getNotification | GET | Get notification rule details |
updateNotification | UPDATE | Update notification rule |
deleteNotification | DELETE | Delete notification rule |
listNotificationLog | LIST | List notification dispatch logs |
getNotificationLog | GET | Get notification log details |
11. Webhooks, Event Logs & File Uploads
| Tool Name | Operation | Description |
|---|---|---|
listWebhook | LIST | List configured webhooks |
createWebhook | CREATE | Register a new webhook endpoint |
getWebhook | GET | Get webhook details |
updateWebhook | UPDATE | Update webhook endpoint config |
deleteWebhook | DELETE | Delete a webhook endpoint |
listWebhookLog | LIST | List webhook delivery attempt logs |
getWebhookLog | GET | Get webhook log details |
listEventLog | LIST | List platform audit event logs |
getEventLog | GET | Get specific event log details |
createUpload | CREATE | Upload media and asset files |
Security Best Practices
Never commit your x-api-secret or MCP configuration files containing secrets to public Git repositories.
- Separate Environment Keys: Use separate API keys for development and production environments.
- Rotate Credentials: If you suspect a key has been compromised, pause or delete it immediately via the API Key management page.
- Least Privilege: Only grant MCP configuration access on trusted developer workstations.
Related Resources
| Resource | Description |
|---|---|
| API Overview | Interactive OpenAPI reference and documentation |
| API Key Management | Create and rotate your admin API keys and secrets |