pallas-mcp-gateway

SKILL.md

---
name: pallas-mcp-gateway
description: Connect to and interact with the Pallas MCP Gateway (pallas-mcp) via mcporter. Provides access to Gmail, Notion, Salesforce, and Slack tools through a unified MCP server interface. Use when the user needs to (1) Authenticate with Pallas MCP Gateway, (2) List available tools, (3) Call MCP tools like Gmail search, Notion page operations, Salesforce queries, or Slack messaging, (4) Refresh the tool list when new capabilities are available.
metadata:
  {
    "openclaw":
      {
        "emoji": "🔌",
        "requires": { "bins": ["mcporter"] },
        "install":
          [
            {
              "id": "node",
              "kind": "node",
              "package": "mcporter",
              "bins": ["mcporter"],
              "label": "Install mcporter (node)",
            },
          ],
      },
  }
---

# Pallas MCP Gateway

This skill enables interaction with the Pallas MCP Gateway (pallas-mcp), a unified MCP server that provides access to Gmail, Notion, Salesforce, and Slack tools.

## Prerequisites

- **mcporter CLI** must be installed (see `metadata.openclaw.install`)
- **Gateway URL**: `https://gw.pallassecurity.com/mcp`

## Authentication

The Pallas MCP Gateway uses OAuth 2.0 authentication. Follow these steps:

### Step 1: Start the Auth Flow

```bash
mcporter auth https://gw.pallassecurity.com/mcp
```

This will output a URL to open in your browser.

### Step 2: Complete OAuth in Browser

1. Open the provided URL in your browser
2. Authenticate with your Pallas account
3. The browser will redirect to a local callback URL (e.g., `http://127.0.0.1:52608/callback?code=...`)

### Step 3: Provide the Code to Polly

Copy the **entire callback URL** from your browser and provide it to Polly. Polly will extract the code and complete authentication.

**Alternative**: If you have the code directly, Polly can use:
```bash
mcporter auth https://gw.pallassecurity.com/mcp --code "YOUR_CODE" --state "YOUR_STATE"
```

### Step 4: Verify Authentication

```bash
mcporter list https://gw.pallassecurity.com/mcp
```

You should see `pallas-mcp` listed with available tools.

## Available Tools

Once authenticated, the gateway provides these tool categories:

| Category | Tools |
|----------|-------|
| **Gmail** | `google-gmail_search_gmail_messages`, `google-gmail_get_gmail_message_content`, `google-gmail_get_gmail_thread_content`, batch operations |
| **Notion** | `notion_API-post-search`, `notion_API-retrieve-a-page`, `notion_API-post-page`, `notion_API-post-database-query`, create/update blocks |
| **Salesforce** | `sfdc_salesforce_query_records`, `sfdc_salesforce_search_all`, `sfdc_salesforce_dml_records`, `sfdc_salesforce_describe_object`, Apex read/write |
| **Slack** | `slack_slack_post_message`, `slack_slack_get_channel_history`, `slack_slack_add_reaction`, `slack_slack_reply_to_thread`, channel/user management |

## Refreshing the Tool List

Since the Pallas MCP Gateway tools are dynamic, refresh the tool list periodically or when new capabilities are added:

### Quick Refresh
```bash
mcporter list https://gw.pallassecurity.com/mcp --output json
```

### Using the Refresh Script
```bash
./skills/installed/pallas-mcp-gateway/scripts/refresh-tools.sh
```

The script will:
1. List all available tools from pallas-mcp
2. Update the cached tool reference at `references/available-tools.md`
3. Show tool counts by category

## Calling Tools

Use the mcporter CLI to call any available tool:

### Gmail Examples
```bash
# Search messages
mcporter call pallas-mcp.google-gmail_search_gmail_messages query="from:boss@company.com" page_size=10

# Get message content
mcporter call pallas-mcp.google-gmail_get_gmail_message_content message_id="MESSAGE_ID"

# Get thread content
mcporter call pallas-mcp.google-gmail_get_gmail_thread_content thread_id="THREAD_ID"
```

### Notion Examples
```bash
# Search pages (sorted by last edited)
mcporter call pallas-mcp.notion_API-post-search sort='{\"direction\":\"descending\",\"timestamp\":\"last_edited_time\"}' page_size=10

# Get a specific page
mcporter call pallas-mcp.notion_API-retrieve-a-page page_id="PAGE_ID"

# Query a database
mcporter call pallas-mcp.notion_API-post-database-query database_id="DB_ID" page_size=10
```

### Salesforce Examples
```bash
# Query records
mcporter call pallas-mcp.sfdc_salesforce_query_records objectName="Account" fields='["Name","Industry"]' limit=10

# Search across objects
mcporter call pallas-mcp.sfdc_salesforce_search_all searchTerm="John" objects='[{\"name\":\"Contact\",\"fields\":[\"FirstName\",\"LastName\"]}]'

# Describe object schema
mcporter call pallas-mcp.sfdc_salesforce_describe_object objectName="Account"
```

### Slack Examples
```bash
# Post a message
mcporter call pallas-mcp.slack_slack_post_message channel_id="C123" text="Hello team"

# Get channel history
mcporter call pallas-mcp.slack_slack_get_channel_history channel_id="C123" pagination_window=20

# Add reaction
mcporter call pallas-mcp.slack_slack_add_reaction channel_id="C123" timestamp="1234567890.123456" reaction="thumbsup"

# Reply to thread
mcporter call pallas-mcp.slack_slack_reply_to_thread channel_id="C123" thread_ts="1234567890.123456" text="Reply message"
```

## Tool Discovery

To see all available tools and their parameters:

```bash
# List all tools with full parameters
mcporter list pallas-mcp --all-parameters

# List tools as JSON (machine-readable)
mcporter list pallas-mcp --output json

# Show specific tool schema
mcporter list pallas-mcp.notion_API-post-search --schema
```

## Troubleshooting

### Authentication Issues

**Problem**: `MCP error -32602: Invalid request parameters` when listing tools

**Solution**: Token may have expired. Re-authenticate:
```bash
mcporter auth https://gw.pallassecurity.com/mcp --reset
```

Then follow the OAuth flow again.

### Timeout Errors

**Problem**: Tool listing times out

**Solution**: The gateway may require authentication. Verify auth status:
```bash
mcporter config list
```

### Tool Not Found

**Problem**: Specific tool call fails with "tool not found"

**Solution**: Refresh the tool list - the gateway tools may have been updated:
```bash
mcporter list https://gw.pallassecurity.com/mcp
```

## Reference Files

- `references/available-tools.md` - Cached list of available tools (auto-generated by refresh-tools.sh)
- `references/authentication.md` - Detailed OAuth flow walkthrough

## Notes

- The Pallas MCP Gateway aggregates multiple service APIs (Gmail, Notion, Salesforce, Slack) through a single MCP interface
- Tool availability depends on the authenticated user's permissions
- OAuth tokens are managed by mcporter and stored in `~/.mcporter/mcporter.json`
- Tool schemas are dynamic - always check the latest tool list before calling tools