clustova-mcp

MCP server for Clustova — AI-powered content generation with SERP analysis, content creation, and humanization. Outputs markdown with YAML frontmatter and JSON-LD schema.

Prerequisites

• Node.js >= 18
• A Clustova account with API access
• A JWT token from your Clustova Dashboard

Installation

npm install -g clustova-mcp

Or run directly with npx:

npx clustova-mcp

Setup

1. Get your API token

Login to Clustova and get your JWT token from Settings → API Access.

2. Configure your AI client

Add to your MCP client config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "clustova": {
      "command": "npx",
      "args": ["-y", "clustova-mcp"],
      "env": {
        "CLUSTOVA_API_TOKEN": "eyJhbGciOiJIUzI1NiIs..."
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "clustova": {
      "command": "npx",
      "args": ["-y", "clustova-mcp"],
      "env": {
        "CLUSTOVA_API_TOKEN": "eyJhbGciOiJIUzI1NiIs..."
      }
    }
  }
}

Tools

generate_content

Generate SEO-optimized blog posts using the full Clustova pipeline (SERP analysis → content generation → humanization).

Parameters:

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | topics | string[] | (required) | Array of topics | | contentType | enum | blog_post | blog_post, tutorial, product_description, news, review, comparison, howto, listicle, affiliate | | tone | enum | professional | professional, casual, friendly, authoritative | | language | string | en | Language code (en, es, fr, de, etc.) | | wordCount | number | 1500 | Target words per topic (100–5000) | | country | string | us | Country code for SERP targeting |

Example:

Generate a blog post comparing kubernetes vs docker swarm with a professional tone, 2000 words

The tool automatically checks your quota before submitting. If you don't have enough words or topics remaining, it will tell you instead of failing.

get_quota

Check your word balance, topic limit, site usage, and current plan.

check_status

Check the progress of a running job by its ID.

list_jobs

List your recent content generation jobs.

Output Format

Content is returned as markdown with YAML frontmatter and JSON-LD schema:

---
title: "Kubernetes vs Docker Swarm in 2026"
slug: "kubernetes-vs-docker-swarm"
seo_title: "Kubernetes vs Docker Swarm | Complete Comparison"
meta_description: "Compare Kubernetes and Docker Swarm..."
focus_keyword: "kubernetes vs docker swarm"
tags: ["kubernetes", "docker", "devops"]
schema_type: "Article"
word_count: 1523
---

## Introduction

Kubernetes has become the de facto standard...

## Comparison Table

| Feature | Kubernetes | Docker Swarm |
|---------|-----------|--------------|
| Setup   | Complex   | Simple       |

---

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Kubernetes vs Docker Swarm in 2026",
  ...
}
</script>

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | CLUSTOVA_API_TOKEN | (required) | JWT token for authentication | | CLUSTOVA_API_URL | https://api.clustova.com/api/v1 | API endpoint URL |

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
CLUSTOVA_API_TOKEN=your-jwt npm start

License

MIT