How to use the Pumble MCP server

With the Pumble Model Context Protocol (MCP) server, you can connect third-party AI agents (e.g., Claude, Gemini, Codex) to Pumble and let them access content so they can search messages, find information, and take actions on your behalf.

How to connect to an MCP server #

To connect your AI assistant to the Pumble MCP server, you will have to create a Pumble addon and take credentials from there. To do this, you will first need to access Pumble addons.

1. Cliquez sur le three dots next to the Workspace name
2. Passez la souris sur Espace de travail sous
3. Sélectionnez Configure apps
   

Once you have opened the Configure apps page, you can add your own addon. Here’s how:

1. Cliquez sur + Create app
2. Sélectionnez Create from scratch
   
3. Enter app name
4. Enter description
5. Select User scopes
6. Select Bot scopes
7. Cliquez sur Install app
   

When the app is installed, make sure to copy the App key, user token, and bot token.

What can you do after connecting to the MCP server? #

The list of available MCP tools is dynamic and depends entirely on the specific scopes you selected when creating an app.

These are all the available tools that the Pumble MCP server lets you use:

• add_reaction_to_message
• add_user_to_channel
• create_call_link
• create_channel
• delete_scheduled_message
• edit_message
• fetch_file
• get_channel_details
• get_channel_messages
• get_channels
• get_latest_messages
• get_scheduled_messages
• get_thread_replies
• get_users
• get_workspace_info
• reply_to_message
• schedule_message
• search_messages
• send_message

Moreover, you can use the following prompts to communicate with the MCP server:

• create-channel-with-initial-users
• explain-pumble-mcp
• send-channel-message
• Send-dm-message

Connect Pumble MCP to Gemini CLI #

When you have created the custom addon, you can connect it to your Gemini CLI. To do so, paste the code below into your settings.json file.

{
  "mcpServers": {
    "pumble-mcp": {
      "httpUrl": "https://mcp.pumble.com/mcp",
      "headers": {
        "token": "user/bot token",
        "x-app-token": "xpat-token"
      },
    }
  }
}

 You can also do this by using the command:

gemini mcp add pumble-mcp https://mcp.pumble.com/mcp \
  --transport http \
  --header "token: token
" \
  --header "x-app-token: xpat-token"

To connect Pumble MCP to your CLI, you will need the App key and user/bot tokens.

Connect Pumble MCP to Claude CLI #

If you are using Claude CLI, you can also connect it to the Pumble MCP server. To do this, paste the code below into your .mcp.json file.

{
  "mcpServers": {
    "pumble-mcp": {
      "type": "http",
      "url": "https://mcp.pumble.com/mcp",
      "headers": {
        "token": "user/bot token"
	"x-app-token": "xpat-token"
      }
    }
  }
}

Or, you can use the following command:

claude mcp add pumble-mcp https://mcp.pumble.com/mcp --transport http --header "token: token" --header "x-app-token: xpat-token"

Connect Pumble MCP to Codex CLI #

The Pumble MCP server can also connect to the Codex CLI. To do this, simply paste the code below into your config.toml file.

[mcp_servers.pumble-mcp]
transport = "http"
url = "https://mcp.pumble.com/mcp"
http_headers = { "token" = "user/bot token", "x-app-token" = "xpat-token" }