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: mcp-browser

Features (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

Related

• linkedin-mcp-server - LinkedIn MCP server (similar approach)

• Waalaxy - Official Waalaxy website

License

Apache-2.0

Contributing

PRs welcome! See CONTRIBUTING.md for guidelines.