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.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    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