# 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:

```http
https://mcp.gamopanda.com/mcp
```

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:

```json
{
  "mcpServers": {
    "gamopanda-admin": {
      "url": "https://mcp.gamopanda.com/mcp",
      "headers": {
        "x-api-key": "<your-api-key>",
        "x-api-secret": "<your-api-secret>"
      }
    }
  }
}
```

:::tip
You can generate your `x-api-key` and `x-api-secret` pair in the Gamopanda dashboard or via the [API Key documentation](/api-key).
:::

---

## 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`:

```json
{
  "mcpServers": {
    "gamopanda-admin": {
      "serverUrl": "https://mcp.gamopanda.com/mcp",
      "headers": {
        "x-api-key": "<your-api-key>",
        "x-api-secret": "<your-api-secret>"
      }
    }
  }
}
```

:::note
Antigravity and Gemini IDE use `"serverUrl"` (instead of `"url"`) for HTTP/SSE endpoints in `mcp_config.json`.
:::

### 2. Cursor IDE

1. Open **Cursor Settings** -> **Features** -> **MCP**.
2. Click **+ Add New MCP Server**.
3. Set **Type** to `sse` or `http`.
4. Enter **URL**: `https://mcp.gamopanda.com/mcp`
5. Add headers `x-api-key` and `x-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`:

```json
{
  "mcpServers": {
    "gamopanda-admin": {
      "url": "https://mcp.gamopanda.com/mcp",
      "headers": {
        "x-api-key": "<your-api-key>",
        "x-api-secret": "<your-api-secret>"
      }
    }
  }
}
```

Alternatively, run the Codex CLI command:

```bash
codex mcp add gamopanda-admin https://mcp.gamopanda.com/mcp --header "x-api-key:<your-api-key>" --header "x-api-secret:<your-api-secret>"
```

---

## 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

:::danger
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](/api-key) page.
- **Least Privilege**: Only grant MCP configuration access on trusted developer workstations.

---

## Related Resources

| Resource | Description |
|---|---|
| [API Overview](/api) | Interactive OpenAPI reference and documentation |
| [API Key Management](/api-key) | Create and rotate your admin API keys and secrets |