stanislavusbest/serpzilla-mcp-stdio-server repository overview

⁠Serpzilla MCP Server

MCP (Model Context Protocol) server for the Serpzilla⁠ API. Enables AI assistants to search donor sites, manage articles, and purchase guest post / link insertion placements for SEO – all through a standardised MCP stdio interface.

⁠Features

• 🔐 Automatic dual authentication (AUTH_TICKET + JWT)
• 📁 Project creation and listing
• 📝 Full article management (create, list, filter)
• 🔍 Advanced donor site search with 30+ filters (DR, traffic, Moz, Ahrefs, Semrush, price, language, etc.)
• 💰 Placement purchasing (guest posts, link insertions, archive links)
• 📊 Placement tracking and bulk actions (approve, cancel, delete drafts)
• 👤 Account info and balance check
• 🐳 Ready-to-run container, communicates via standard I/O (stdio)

⁠Prerequisites

• A Serpzilla account⁠ with an API token.
• Docker (no Python installation needed).

⁠Quick Start

Run the container interactively with your credentials:

docker run -i --rm \
  -e SERPZILLA_LOGIN="[email protected]" \
  -e SERPZILLA_API_TOKEN="your_api_token" \
  stanislavusbest/serpzilla-mcp-stdio-server:latest

The server reads JSON-RPC messages from stdin and writes responses to stdout.

⁠Enabling Logs

To persist logs, mount a writable file and set ENABLE_LOGS=true:

touch /var/log/serpzilla-mcp-stdio-server.log
chmod 666 /var/log/serpzilla-mcp-stdio-server.log

docker run -i --rm \
  -v /var/log/serpzilla-mcp-stdio-server.log:/var/log/serpzilla-mcp-stdio-server.log \
  -e SERPZILLA_LOGIN="[email protected]" \
  -e SERPZILLA_API_TOKEN="your_api_token" \
  -e ENABLE_LOGS=true \
  stanislavusbest/serpzilla-mcp-stdio-server:latest

⁠Environment Variables

⁠Integration with MCP Clients

⁠OpenClaw / Claude Desktop

npx mcporter config add serpzilla --stdio \
 "docker run -i --rm --env SERPZILLA_LOGIN=XXX --env SERPZILLA_API_TOKEN=XXX stanislavusbest/serpzilla-mcp-stdio-server:latest"

⁠Generic MCP Host

Configure the client to spawn the container with the environment variables shown above. The server implements initialize, tools/list, and tools/call as per the MCP specification.

⁠Links

• Source code & documentation: GitHub Repository⁠
• Official Serpzilla API: OpenAPI spec⁠
• Official Serpzilla API Documentation with Swagger UI⁠
• Top up balance: Serpzilla Deposit⁠

Disclaimer: This is an unofficial MCP server. Use it in accordance with Serpzilla's terms of service.