Skip to main content
Glama
Waalaxy MCP Server

Waalaxy MCP Server

by artik0din

Waalaxy MCP Server

MCP (Model Context Protocol) server for Waalaxy - LinkedIn automation tool.

⚠️ Status: In Development

Waalaxy does not provide a public API. This MCP server uses browser automation (Playwright) to interact with the Waalaxy web interface.

Related MCP server: LinkedIn MCP

Features (Planned)

Tool

Description

Status

get_campaigns

List all campaigns

πŸ”„ Planned

get_campaign_stats

Get campaign statistics

πŸ”„ Planned

get_prospects

List prospects in a campaign

πŸ”„ Planned

get_conversations

Get LinkedIn conversations

πŸ”„ Planned

create_campaign

Create a new campaign

πŸ”„ Planned

add_prospects

Add prospects to a campaign

πŸ”„ Planned

send_message

Send a message to a prospect

πŸ”„ Planned

get_analytics

Get account analytics

πŸ”„ Planned

Prerequisites

  • Python 3.10+

  • uv package manager

  • Playwright with Chromium

  • Active Waalaxy account

Installation

# Install dependencies
uv sync

# Install Playwright browsers
uvx playwright install chromium

# Create session (first time)
uvx mcp-server-waalaxy --get-session

Configuration

{
  "mcpServers": {
    "waalaxy": {
      "command": "uvx",
      "args": ["mcp-server-waalaxy"]
    }
  }
}

Session Management

Session is stored at ~/.waalaxy-mcp/session.json. Re-run --get-session if authentication expires.

Development

# Clone the repo
git clone https://github.com/globodai-group/mcp-server-waalaxy.git
cd mcp-server-waalaxy

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest

Architecture

Since Waalaxy lacks a public API, this server:

  1. Uses Playwright to control a headless browser

  2. Authenticates via saved session cookies

  3. Scrapes/interacts with the Waalaxy web app

  4. Exposes functionality as MCP tools

License

Apache-2.0

Contributing

PRs welcome! See CONTRIBUTING.md for guidelines.

Available Tools

6 tools
close_sessionA

Close browser session and clean up resources

Inputs: no named parameters.

get_analyticsC

Get account analytics and statistics

Inputs: period.

get_campaignsC

Get all campaigns from Waalaxy

Inputs: status.

get_campaign_statsC

Get statistics for a specific campaign

Inputs: campaign_id (required).

get_conversationsC

Get LinkedIn conversations from Waalaxy inbox

Inputs: filter, limit.

get_prospectsB

Get prospects from a campaign or list

Inputs: campaign_id, list_id, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: session management, analytics, campaigns listing, campaign stats, conversations, and prospects. No overlap or ambiguity.

    Naming Consistency5/5

    All tools consistently use the verb_noun pattern with lowercase and underscores. Verbs are either 'close' or 'get', which is predictable and clear.

    Tool Count5/5

    With 6 tools covering the core functionalities of a Waalaxy automation server (campaigns, prospects, conversations, analytics, session), the count is well-scoped and each tool earns its place.

    Completeness2/5

    The tool surface is heavily read-only, missing write operations for campaigns (create, update, delete), prospects (create, update, delete), and conversations (send messages). This severely limits automation capabilities.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for programmable LinkedIn automation via Playwright, offering 20 tools for profile management, messaging, feed interaction, and job searching through real browser automation.
      18 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables MCP clients to automate a real Chrome browser via Playwright, supporting session sharing and tools for navigation, clicking, typing, and more.
      11
      108 npm
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Playwright-powered MCP server for LinkedIn that automates jobs, profile edits, messaging, network actions, and feed posts using a real logged-in browser session.
      36
      Apache 2.0