# Clearscope MCP for AI Agents AI Agent Connect > Clearscope MCP lets you run SEO audits, grade content drafts, and pull keyword data directly through your AI agent. It connects your Clearscope account so you can handle SERP analysis and content briefs without switching tabs. ## Overview - **Category:** growth-engine - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_f9vBZKkyMmFaUZK6QU3tJeL8GH6952YtpqfQHh5W/ai-agent-connect - **Tags:** content-optimization, nlp-grading, topical-authority, serp-analysis, keyword-research, content-strategy ## Description Stop jumping between your browser and your content editor just to check if your draft actually hits the right keywords. This Connector connects your Clearscope account to your AI agent so you can handle the heavy lifting of SEO research and content grading in one place. Instead of manually digging through SERP results to see what your competitors are doing, you can just ask your agent to pull out their outlines and term frequencies. You can also get your drafts graded against specific NLP boundaries to see exactly where you're falling short of an A++ score. If you're stuck on a new topic, it can generate structural briefs with target word counts and semantic requirements instantly. It's a huge time saver for anyone who needs to maintain topical authority while keeping their output high-quality. By adding this to your Vinkius setup, you're essentially giving your AI agent a direct line to professional-grade SEO data. You get to focus on the actual writing while the agent handles the data crunching, keyword limits, and competitor gap analysis. ## Tools ### get_report_details See the specific NLP scoring boundaries for an active report. This tells you exactly what terms are needed. ### grade_content Check your text against mapped NLP bounds to see your current SEO grade. It tells you which keywords you're missing. ### list_reports Find and view your top-level content SEO reports. This helps you track your overall SEO performance. ### create_report Start a new report to parse SERP results and execution hooks. This initiates the data collection process. ### get_keyword_research See Google traffic limits and CPC for specific keywords. Use this to determine if a term is worth targeting. ### list_terms Get a list of NLP bounding variables and term frequencies. This helps you see how often specific words appear. ### list_competitors Identify the active links and competitors in a native SERP. Use this to see who is currently ranking. ### get_outline Pull structural string arrays that define content hierarchies. This shows you how competitors structure their pages. ### get_brief Get specific instructions and writing boundaries for a content piece. Use this to generate a clear content plan. ### list_workspaces View and switch between different organizational containers. This keeps your different projects organized. ## Prompt Examples **Prompt:** ``` Can you look at the top results for 'best coffee makers' and tell me what headings they use? ``` **Response:** ``` ### Top Competitor Outlines I've analyzed the top results for **best coffee makers**. Here is the common structural hierarchy: * **What is a Drip Coffee Maker?** * **Top 10 Best Coffee Makers of 2024** * *Best for Small Spaces* * *Best for Offices* * **Buying Guide: What to Look For** * *Capacity* * *Brewing Time* * **Comparison Table** * **Conclusion & Recommendations** ``` **Prompt:** ``` I have a draft about eco-friendly packaging. Grade it against the 'sustainable shipping' report. ``` **Response:** ``` ### Content Grade: B Your draft is currently at a **B** grade. To reach **A++**, you need to include the following high-priority terms: * **Biodegradable materials** * **Carbon-neutral shipping** * **Plastic-free alternatives** **Suggestions:** * Add a section on *biodegradable materials* in the intro. * Mention *plastic-free alternatives* when discussing shipping costs. ``` **Prompt:** ``` Give me a content brief for a 1000-word guide on urban gardening. ``` **Response:** ``` ### Content Brief: Urban Gardening Guide **Target Word Count:** 1,000 words **Primary Topics:** * Small-space gardening * Vertical planting * Hydroponics for beginners **Structural Outline:** 1. **Introduction** (Why urban gardening is growing) 2. **Choosing Your Space** (Balconies vs. Windowsills) 3. **Vertical Gardening Techniques** 4. **Hydroponics vs. Soil** 5. **Best Low-Light Plants** 6. **Conclusion & Next Steps** ``` ## Capabilities ### Grade content drafts Get real-time NLP scores for your text to see how well it matches target keywords. ### Pull competitor outlines Extract the structural hierarchy of the top search results for any keyword. ### Generate content briefs Create structural outlines with target word counts and required semantic topics. ### Identify keyword metrics Retrieve traffic limits and CPC for any keyword in the Clearscope database. ### Manage workspaces Navigate between different organizational folders to keep content projects separate. ### Extract term frequencies See which specific terms are appearing most often in the search results. ## Use Cases ### Analyzing competitor structures A writer is stuck on a blog post and uses `get_outline` to see how competitors structured their top 3 results. ### Validating keyword viability An SEO lead needs to check keyword viability and uses `get_keyword_research` to pull CPC and traffic limits for a list of terms. ### Auditing draft quality A content manager wants to audit a draft and uses `grade_content` to see which terms are missing from the current text. ### Starting new product pages A team is starting a new product page and uses `create_report` to audit the topical authority of the current SERP. ## Benefits - Stop manual tab switching by using `get_keyword_research` to see traffic limits and CPC inside your chat. - Get immediate feedback on your drafts using `grade_content` to hit that A++ NLP score faster. - Build better content plans by pulling competitor structures with `get_outline` and `list_competitors`. - Save hours of research by using `get_brief` to generate structural outlines and word counts automatically. - Manage complex projects easily by switching between different organizational folders with `list_workspaces`. ## How It Works The bottom line is you get professional SEO insights and content grading directly inside your AI chat interface. 1. Subscribe and provide your Clearscope API Key (Business or Enterprise plan required). 2. Connect the Connector to your AI client like Claude or Cursor. 3. Ask your agent to perform SEO tasks like grading drafts or pulling keyword data. ## Frequently Asked Questions **Can Clearscope MCP help me rank higher on Google?** Yes, it helps you align your content with what search engines actually want by providing real-time SERP data and NLP grading to ensure you cover the right topics. **Do I need a special plan for this to work?** To use this Connector, you will need a Clearscope Business or Enterprise plan, as it requires access to their API for data retrieval. **How does it help with content briefs?** It pulls real-time search result data to create structural outlines and briefs, telling you exactly what to write about to compete with top results. **Can it analyze my competitors?** Yes, it can extract outlines and term frequencies from the top 30 search results, showing you exactly how your competitors are structured. **What is NLP grading?** It is a way to see if your content covers the right topics. The Connector checks your text against specific linguistic boundaries to give you an SEO grade. **Can I use this with Cursor?** Yes, you can connect this Connector to Cursor, Claude, or any other MCP-compatible client to perform your SEO research directly in your workspace. **Can my agent grade my content drafts in real-time?** Yes. Provide the report ID and your content text. The agent calls Clearscope's NLP engine to return an exact SEO grade (from A++ to F), identifying which terms you've covered and which ones are missing for optimal ranking. **How can I extract the structural outline of my top search competitors?** Use the 'get_outline' tool. Your agent will fetch the H2 and H3 heading hierarchies from the top-ranking results for your keyword, helping you understand the document structure needed to compete on Google. **Does the agent help with keyword research and traffic volume?** Absolutely. The 'get_keyword_research' tool provides search volume, CPC, and competitiveness data directly from Clearscope's database. This allows your agent to suggest target keywords based on actual market demand.