# Clearscope MCP for AI Agents MCP

> Clearscope lets you manage and optimize content performance directly from your chat client. You can generate full SEO reports to audit topical authority, grade drafts in real-time using advanced NLP checks, and run deep keyword research to identify traffic potential for any topic.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** content-optimization, nlp-grading, topical-authority, serp-analysis, keyword-research, content-strategy

## Description

Think of this MCP as a central command center for all things search visibility. Instead of bouncing between Clearscope's web dashboard and your writing tool—and then switching to a spreadsheet for competitor analysis—you keep everything in one conversation with your agent. You can ask it to create an SEO report, check how well your draft scores against current trends, or pull up the competitive structure of the top-ranking pages for any keyword.

When you connect Clearscope via Vinkius, you get full control over your search discoverability right from Claude, Cursor, or any compatible agent. You can generate structural outlines and content briefs that tell you exactly what topics to cover next. This means less guessing and more predictable ranking improvements.

## Tools

### list_reports
Retrieves a list of available content SEO reports for auditing your site's performance.

### get_report_details
Pulls specific data points from an existing report, like NLP scores and topical gaps.

### create_report
Starts a new SEO performance audit for a given topic or keyword on the search engine results page.

### grade_content
Scores your submitted text and highlights specific terms or concepts missing to boost its rank.

### get_keyword_research
Provides data on a keyword, including estimated search volume and competitive difficulty.

### list_terms
Extracts all related semantic terms that should be included in content about a specific topic.

### list_competitors
Identifies the top competing links on Google for a given keyword and topic.

### get_outline
Extracts the structural hierarchy (H2/H3) used by top competitors to organize their articles.

### get_brief
Generates a structured content brief with specific topics and word count recommendations for writers.

### list_workspaces
Shows you the different organizational accounts or client projects you have set up.

## Prompt Examples

**Prompt:** 
```
What are the top 3 competitors ranking for 'advanced cybersecurity training'?
```

**Response:** 
```
**Top Competitors for Cybersecurity Training:**

1. **SecurityCorp:** Focuses heavily on compliance and certifications (H2: HIPAA, PCI DSS).
2. **LearnAI:** Uses a module approach, listing specific skill tracks (H2: ML Ops, Quantum Security).
3. **GlobalTech Ed:** Emphasizes career paths and job placement (H2: Career Ladder, Salary Expectations). 

*Actionable Insight:* All three mention 'Cloud Native' in their secondary headings, which you should incorporate.
```

**Prompt:** 
```
Grade this draft against the report for 'best AI tools 2024': [draft text]
```

**Response:** 
```
✅ **Content Grade: B+**

Your piece is strong, but it's missing key context points that will hurt its ranking. Specifically, you need to include terms like *workflow automation* and *LLM integration*. These are highly relevant right now.

To hit an A grade, try adding a section comparing 'GPT-4o vs Claude 3' or detailing the cost structure of these tools.
```

**Prompt:** 
```
What kind of content should I write about 'sustainable urban gardening'? 
```

**Response:** 
```
**Content Brief Generated!**

Based on current SERP data, your article needs to cover these topics:

*   **Structural Outline:** (H2: Raised Bed Basics | H2: Water Conservation Techniques)
*   **Target Word Count:** 1,800 words.
*   **Must Include Semantics:** 'Composting methods,' 'native plant selection,' and 'hydroponic systems' are mandatory for a high grade. 

Use these guidelines to create a full content strategy.
```

## Capabilities

### Audit Content Performance
Create reports detailing your site's topical authority and overall search performance.

### Grade Draft Quality
Run advanced NLP checks that score your draft content against SEO best practices.

### Identify Keyword Potential
Research specific keywords to find projected traffic limits and competitive costs (CPC).

### Analyze Competitor Structure
Extract the full outlines, heading structure, and key topics used by top-ranking competitors.

### Generate Content Plans
Create detailed structural briefs for new articles, including target word counts and required semantic topics.

## Use Cases

### A new article needs a topic plan
The writer asks the agent for content ideas around 'best remote work tools.' The agent uses `get_brief` to deliver a complete structural outline, including target word counts and 15 required semantic topics. This eliminates hours of brainstorming.

### Checking if existing content is ranking well
The marketing manager runs an audit using `create_report` for the keyword 'SaaS marketing trends.' The agent returns a full SEO report, showing exactly where the site's topical authority falls short compared to competitors.

### Figuring out what makes competitors better
The editor asks about a top-ranking article. The agent uses `list_competitors` and then runs `get_outline`, showing the full H2/H3 structure (e.g., 'Pricing' or 'Use Cases') that every major competitor is using.

### Improving a draft before it goes live
The team member pastes a rough article and asks to grade it against the report ID 'report_xyz'. The agent uses `grade_content`, pointing out five specific terms like 'machine learning' that must be added for an A+ score.

## Benefits

- Stop writing in a vacuum. Use the `get_brief` tool to generate structural outlines that tell you exactly what topics and subheadings your audience needs, ensuring every piece of content is strategically targeted.
- Improve grades instantly by running drafts through `grade_content`. The agent will point out missing key phrases or concepts, allowing you to hit A++ status before publishing.
- Cut down on manual research time. Instead of guessing keywords, use `get_keyword_research` to get clear data on traffic potential and competition difficulty for any term.
- Understand the battlefield better. The agent can run competitor analysis using `list_competitors` and then extract their full structural hierarchy with `get_outline`. This reveals exactly how top sites organize their content.
- Keep your projects separated. Use `list_workspaces` to jump between different client accounts, keeping all your SEO data isolated and organized within the chat.

## How It Works

The bottom line is, your AI agent uses this MCP to access Clearscope’s full suite of professional SEO tools without needing any web browser interaction.

1. First, subscribe to the Clearscope MCP on Vinkius.
2. Next, input your Clearscope API Key (requires a Business or Enterprise plan) into your AI client's settings.
3. Finally, you simply ask your agent for a report, a grade, or competitor analysis right in the chat.

## Frequently Asked Questions

**How does Clearscope help me figure out what keywords I should target?**
The MCP helps you research keyword potential by providing data on estimated search volume and the current difficulty level for any topic. This tells you if a keyword is worth writing about, saving you time researching weak topics.

**Can Clearscope grade my articles against SEO best practices?**
Yes. The agent runs advanced NLP checks on your draft text and gives you an immediate score. It doesn't just say 'good'; it points out the exact missing terms or concepts needed to boost your rank.

**What is SERP analysis with Clearscope MCP?**
SERP analysis lets you see exactly what Google shows for a topic. The agent extracts competitor outlines and reveals which headings, like 'Pricing' or 'Benefits,' the top sites are using successfully.

**How do I use Clearscope to create content ideas?**
You can generate full content briefs that act like a blueprint. The agent provides a structural outline and specifies required semantic topics, so you write with intent from day one.

**I am an SEO specialist. What is the best way to audit my site's performance?**
You can initiate a full report using the MCP to audit your topical authority and search performance. This gives you a high-level view of where your content strategy needs immediate attention.