Waalaxy MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Waalaxy MCP Server list my campaigns"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| List all campaigns | π Planned |
| Get campaign statistics | π Planned |
| List prospects in a campaign | π Planned |
| Get LinkedIn conversations | π Planned |
| Create a new campaign | π Planned |
| Add prospects to a campaign | π Planned |
| Send a message to a prospect | π Planned |
| 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-sessionConfiguration
{
"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 pytestArchitecture
Since Waalaxy lacks a public API, this server:
Uses Playwright to control a headless browser
Authenticates via saved session cookies
Scrapes/interacts with the Waalaxy web app
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.
Available Tools
6 toolsclose_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
Scored across 6 tools
Each tool has a clearly distinct purpose: session management, analytics, campaigns listing, campaign stats, conversations, and prospects. No overlap or ambiguity.
All tools consistently use the verb_noun pattern with lowercase and underscores. Verbs are either 'close' or 'get', which is predictable and clear.
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.
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
Related MCP Connectors
Run LinkedIn, email, WhatsApp and iMessage outreach from any MCP client.
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
LinkedIn actions for AI agents: search, messaging, posts and invites, as hosted MCP tools.
LinkedIn outreach MCP server β 19 tools for AI agents to prospect, sequence, and manage contacts.
Related MCP Servers
- FlicenseBqualityDmaintenancePlaywright wrapper for MCP that enables LLM-powered clients to control a browser for automation tasks.101-
- AlicenseNot gradedqualityDmaintenanceMCP server for programmable LinkedIn automation via Playwright, offering 20 tools for profile management, messaging, feed interaction, and job searching through real browser automation.18 npmMIT
- AlicenseAqualityDmaintenanceEnables MCP clients to automate a real Chrome browser via Playwright, supporting session sharing and tools for navigation, clicking, typing, and more.11108 npm2MIT
- AlicenseBqualityDmaintenancePlaywright-powered MCP server for LinkedIn that automates jobs, profile edits, messaging, network actions, and feed posts using a real logged-in browser session.36Apache 2.0