# SEO Content Brief Scorer MCP

> SEO Content Brief Scorer audits content briefs against SEO best practices before you start writing. It checks structural elements like title length, keyword placement in headings, and heading flow to spot optimization gaps that hurt search rankings.

## Overview
- **Category:** seo
- **Price:** Free
- **Tags:** seo, content-optimization, keyword-research, auditing, content-strategy

## Description

Writing great content starts with a flawless plan. This MCP lets your AI client evaluate your entire content brief—the roadmap for an article—against current SEO standards. You won't just guess if it's good enough; you get concrete feedback on structure, keywords, and flow before the first draft hits the page. The system checks everything from how deep your header tags go to whether your main target terms are actually featured in high-visibility spots like H1 or H2 headings. When you connect this MCP through Vinkius, your agent can run these audits instantly, giving you an overall score and a prioritized list of fixes. You simply tell it the brief details, and it points out exactly where you need to adjust the structure to rank higher.

## Tools

### analyze_keyword_placement
Checks if your target keywords are integrated into the highest-impact structural zones like H1 and H2 headings.

### audit_heading_hierarchy
Validates that your content outline follows a logical nesting order (e.g., you can't jump from H1 straight to H3).

### calculate_brief_score
Generates an overall score for the entire content brief, pinpointing general health issues.

## Prompt Examples

**Prompt:** 
```
Can you check if this content brief is SEO-ready? Title: 'Best Running Shoes 2024', Keywords: ['running shoes', 'marathon training'], Headings: [{'tag': 'H1', 'text': 'Best Running Shoes 2024'}, {'tag': 'H2', 'text': 'Marathon Training Tips'}], Word Count: 1500
```

**Response:** 
```
The brief is in the Optimal tier with a high SEO health score. Your target keywords are well-placed in the H1 and H2 headings.
```

**Prompt:** 
```
Analyze the keyword placement for this brief: Title: 'SEO Guide', Keywords: ['seo strategy', 'backlinks'], Headings: [{'tag': 'H1', 'text': 'SEO Guide'}, {'tag': 'H2', 'text': 'Introduction'}]
```

**Response:** 
```
The coverage rate is 0%. The keywords 'seo strategy' and 'backlinks' are not found in the title or high-impact H1/H2 headings.
```

**Prompt:** 
```
Check this heading structure for errors: [{'tag': 'H1', 'text': 'Main Title'}, {'tag': 'H3', 'text': 'Subtopic'}]
```

**Response:** 
```
The hierarchy is invalid. The tool detected skipped levels: H2 was bypassed.
```

## Capabilities

### Determine SEO Health Score
The tool calculates an overall score for your content plan, immediately highlighting areas that need improvement.

### Check Keyword Focus Areas
It verifies whether key target phrases are properly included in the article's title or main section headings.

### Verify Structural Flow
The MCP ensures that your heading tags follow a logical, nested order (like H1 -> H2 -> H3), preventing structural errors.

## Use Cases

### Launching a pillar page on 'Advanced Gardening'
A strategist needs to write a huge guide. They ask their agent to run the brief through the MCP. The tool finds that while keywords are present, the heading structure is flat (missing H3s). This allows them to expand subtopics immediately instead of drafting content blind.

### Updating an old article's plan
A writer wants to revitalize a piece about 'Remote Work Tools'. They use the MCP to calculate_brief_score. The tool flags that the primary keyword isn't in the H1, prompting them to rewrite the title and boost the score.

### Checking client submissions
An SEO manager receives a plan from a freelance writer. They use the MCP’s audit_heading_hierarchy tool. The system immediately reports that H2 was skipped, saving hours of manual review and ensuring structural integrity.

## Benefits

- Guarantee proper keyword usage. Use analyze_keyword_placement to confirm that key terms appear in the title and main headings, which search engines prioritize.
- Avoid structural penalties. The audit_heading_hierarchy tool catches skips or repetitions in your header tags, keeping your content technically sound.
- Get a quick health grade. calculate_brief_score provides an immediate, actionable score, letting you see exactly how far off track the brief is without guesswork.
- Save time on revisions. Instead of waiting for manual SEO review, your agent gets instant structural feedback, accelerating the planning phase.
- Improve content depth. By enforcing a logical heading flow, this MCP helps ensure your article structure supports complex, topic-rich coverage.

## How It Works

The bottom line is you get an immediate, objective audit of your content plan's structural integrity before writing any copy.

1. Feed the content brief details—including title, target keywords, and planned headings—to your AI client.
2. Your agent sends this data to the MCP, which runs multiple checks against established SEO guidelines.
3. You receive a comprehensive report detailing an overall score and specific instructions on how to fix keyword gaps or correct heading levels.

## Frequently Asked Questions

**What is the main difference between calculate_brief_score and audit_heading_hierarchy?**
calculate_brief_score gives you a general grade (the 'what'), while audit_heading_hierarchy fixes structural problems (the 'how'). The score synthesizes all findings, including hierarchy issues.

**Can I use the SEO Content Brief Scorer for existing articles?**
The tool is designed to audit *briefs*, which are plans. If you need to check an already published article, you'll need a different auditing MCP that accepts full text input.

**Does analyze_keyword_placement only look at the H1 and H2 tags?**
It focuses on high-impact zones like the title and major headings (H1/H2) because these are what search engines pay closest attention to first.

**How many tools does SEO Content Brief Scorer MCP have?**
The MCP includes three focused tools: calculate_brief_score, analyze_keyword_placement, and audit_heading_hierarchy. They work together to give a complete picture.

**Is this better than using a general SEO writing tool?**
General tools might help you write the copy, but this MCP focuses solely on pre-writing structural auditing. It catches planning flaws that other tools miss.