# Pumble MCP

> Pumble MCP connects your AI agent directly into the Pumble communication workspace. It lets you manage team discussions, read conversation history across every channel, create new project channels on demand, and pull detailed user profiles for accurate tagging. Use it to automate status updates, organize community Q&A sessions, or broadcast standardized announcements without ever leaving the chat interface.

## Overview
- **Category:** collaboration-tools
- **Price:** Free
- **Tags:** messaging, team-collaboration, channel-management, automation, user-directory

## Description

You can connect your AI agent right into Pumble to automate how teams communicate. Instead of manually checking different channels for project statuses, you ask your agent to list all open and private discussion hubs; it gives you a full map of your workspace. Need to kick off a new initiative? Your agent creates the channel instantly. It doesn't just talk about messages—it handles them. You can retrieve entire conversation histories or post updates directly into specific threads, even correcting typos on old announcements. For tracking team members, your agent lists all users and pulls key details like emails and time zones so you know who to tag. This capability is available through the Vinkius Marketplace, giving your AI client access to robust communication tools without needing custom integrations.

## Tools

### chat_add_reaction
Adds a specific emoji reaction to any message in Pumble.

### chat_delete_message
Permanently deletes a specified message from a Pumble channel. This action cannot be undone.

### chat_history_messages
Retrieves and displays recent messages from any given chat channel.

### chat_post_message
Sends a new message to a specified Pumble channel using provided text and channel ID.

### chat_update_message
Modifies the content of an existing, pre-written message within a chat thread.

### create_chat_channel
Creates and provisions a new communication channel; you can specify its name and whether it should be private.

### get_channel_info
Retrieves comprehensive, detailed information about one specific Pumble channel.

### get_user_info
Pulls full profile details for a single user in the workspace, including their email and time zone.

### list_all_channels
Lists every public and private channel that exists across your entire Pumble workspace.

### list_workspace_users
Retrieves a complete directory listing of all users connected to the Pumble workspace.

## Prompt Examples

**Prompt:** 
```
List all our active channels in Pumble.
```

**Response:** 
```
I found 5 active channels in your workspace. The main ones are `#general`, `#dev-updates`, and `#marketing-q4`. Which one should I inspect?
```

**Prompt:** 
```
Post a message in the #dev-updates channel stating that 'Deployment 2.1 is completed'.
```

**Response:** 
```
Done! I've securely posted 'Deployment 2.1 is completed' to the `#dev-updates` channel.
```

**Prompt:** 
```
Read the last 3 messages from #marketing-q4 and react to the last one with a 'thumbsup'.
```

**Response:** 
```
Here's what was discussed in #marketing-q4: 
1. User A: 'Are the assets ready?'
2. User B: 'Yes, loaded in drive.'
3. User A: 'Perfect, deploying campaigns.'
I also successfully placed a 👍 reaction on User A's last message.
```

## Capabilities

### Discovering Channels
The agent can list all public and private channels in your workspace or fetch detailed information about a specific channel.

### Managing Communications
You can send new messages, update existing ones, add emoji reactions to acknowledge requests, or delete outdated announcements.

### User Directory Lookup
The agent lists all workspace users and pulls detailed profiles, including emails and time zones, for accurate team tagging.

## Use Cases

### Onboarding New Department Teams
An Operations Lead asks their agent: 'Create three new channels for Q3 marketing initiatives (A, B, C) and post the standard welcome message in all of them.' The agent uses `create_chat_channel` and then multiple `chat_post_message` calls to provision and populate everything instantly.

### Tracking Down a Specific User's Role
A Community Manager needs to know if John Doe is in the EU time zone. They ask their agent, which uses `get_user_info` on John Doe to pull his full profile data and confirm details like email and time zone.

### Summarizing a Long Debate
An Engineering Manager wants a quick summary of the last week's discussion. They instruct their agent to run `list_all_channels` to find the right channel, then use `chat_history_messages` to pull the latest content for review.

### Managing Outdated Info
A team needs to delete an old announcement that was posted in error. They direct their agent to locate the message using `chat_history_messages`, and then execute `chat_delete_message` to permanently remove it.

## Benefits

- Instant Channel Provisioning: Need a new project channel? Use the `create_chat_channel` tool to spin up and name a dedicated discussion hub instantly, eliminating manual setup steps.
- Centralized Communication History: Never hunt through threads again. With `list_all_channels` and `chat_history_messages`, your agent reads every message in scope so you never miss context.
- Accurate User Tagging: The `list_workspace_users` tool provides full user profiles, including emails and time zones. Your agent can ensure you tag the right person, reducing reply delays.
- Message Control: Don't just read; act. You can send updates using `chat_post_message`, or use `chat_update_message` to correct announcements without creating confusing follow-up messages.
- Quick Acknowledgment: Use `chat_add_reaction` to quickly acknowledge a request with an emoji, keeping the main chat flow clean and professional.

## How It Works

The bottom line is that once connected, your agent acts as a native command center for all things happening inside Pumble.

1. Subscribe to this MCP on the Vinkius Marketplace.
2. Authorize access using your Pumble API Key (which you generate in-app).
3. Your AI client can then run commands, letting you manage channels and messages directly through natural conversation.

## Frequently Asked Questions

**How do I securely obtain my API Key?**
Installation in Pumble is unique. In your workspace, click **+ Add apps** in the left sidebar, find the **API** addon, and install it. After doing so, go to any chat input box in Pumble and type `/api-keys generate`. A private, ephemeral message will appear containing your secret token. Paste that token here.

**Can my AI automatically reply to unread issues?**
Yes. You can instruct your agent to regularly fetch messages from a specific channel (`chat_history_messages`). The agent can evaluate questions, generate answers based on your knowledge base, and then use `chat_post_message` to post the solution back to the team instantly.

**Is it possible for the AI to react with emojis?**
Absolutely. It uses the `chat_add_reaction` functionality. A common use case is having the agent process a batch of tickets reported in Pumble, and instruct it to leave a '✅' checkmark reaction on the original message to signify that work is complete.

**What happens if a bot message has a typo?**
Unlike standard webhooks, this integration provides full bidirectional control. If your AI posted something incorrect, simply ask it to update its previous message. It will fetch its message ID and push a new payload using the `chat_update_message` tool instantly without leaving double messages.