BlogSEO

BlogSEO MCP server and agent plugin

BlogSEO plans, writes and publishes SEO content for your website. Its remote MCP server lets an AI assistant do that work on your account: research keywords, read Google Search Console rankings, plan the content calendar, write and edit articles, score them against competitors, publish to your CMS and follow your backlinks.

• Server URL: https://mcp.blogseo.io/mcp (Streamable HTTP)
• Authentication: OAuth 2.1, no API key. The first connection opens the BlogSEO consent page, where you choose which websites the assistant may use.
• Requirement: a BlogSEO account with at least one website.

This repository also packages the server as an Agent Plugin with three skills, and holds the client manifests for Cursor and Claude Code.

What the server does

52 tools, grouped by job:

Area	What the assistant can do
Keywords	List tracked keywords with volume, difficulty and Search Console positions, research new ones from seed keywords, refresh metrics, expand topic clusters, find cannibalization, compare rankings between two periods
Content calendar	Read the schedule, add articles with a brief and a target keyword, reschedule, edit or remove pending articles, suggest headlines
Articles	List and read articles, update the headline, slug, meta description, cover image and alt text, edit content with AI, publish or sync to the connected CMS
SEO checks	On-page SEO score for an article or pasted content, competitor benchmark, AI improvements, keyword density of any page
Backlinks	Links placed through the BlogSEO exchange, Domain Rating and backlink profile of any domain
Integrations	List connections, connect and test a custom webhook, set up a hosted blog, read the webhook contract
Account	Websites the connection may use, credit balances, plan and website settings

Reading data is free. Tools that spend credits (keyword research, AI edits, competitor benchmarks) answer with the cost first and only run after an explicit confirmation. Destructive tools are annotated, so the client asks before running them. Tokens, payment data and integration credentials are never returned.

Configure

VS Code and GitHub Copilot. Add the server to .vscode/mcp.json in your workspace, or to your user MCP configuration:

{
    "servers": {
        "blogseo": {
            "type": "http",
            "url": "https://mcp.blogseo.io/mcp"
        }
    }
}

Or from a terminal:

code --add-mcp '{"name":"blogseo","type":"http","url":"https://mcp.blogseo.io/mcp"}'

Start the server from the MCP view, sign in to BlogSEO in the browser window that opens, choose the websites and approve. The tools are then available to Copilot Chat in agent mode.

Cursor. Install from the Cursor Directory, or open Customize in the sidebar, find BlogSEO in the marketplace and click Install. One-click server install without the plugin: Add to Cursor. For local testing, clone this repo into ~/.cursor/plugins/local.

Claude Code.

claude plugin marketplace add BlogSEO-io/blogseo-agent-plugin
claude plugin install blogseo@blogseo

Claude, ChatGPT and any other client. Add https://mcp.blogseo.io/mcp as a remote MCP server or custom connector. The setup guide covers every client. Any Agent Plugins client can also load a clone of this repository.

Access. On the consent page you grant all the websites you administer or only some of them. Websites where you are a plain member are never available. Revoke a connection at any time under Settings > Security in the BlogSEO app.

Use

Ask in plain language and the assistant picks the tools:

• "Show my keywords ranking between position 5 and 15 with the most impressions, and what to change on each page to reach page 1."
• "Compare my search clicks over the last 28 days with the 28 days before. Which pages lost traffic and why?"
• "Schedule an article for next Monday targeting 'cold email deliverability' and brief it to compare Gmail and Outlook filtering."
• "Score my latest article, apply the top three fixes and sync it to my CMS."
• "Which of my articles compete for the same keyword?"

With several websites on the account, name the website in the prompt or let the assistant ask which one.

What is inside

Path	Purpose
plugin.json	Agent Plugins manifest
mcp.json	The BlogSEO remote MCP server (Streamable HTTP)
skills/blogseo-seo-workflows	Playbooks for keywords, calendar, articles, scores, backlinks and multi-site accounts
skills/blogseo-plug-website	Connecting a custom-built site: hosted blog or custom webhook
skills/blogseo-article-images	Replacing images from local files or URLs, alt text
.cursor-plugin/, .claude-plugin/, .mcp.json	Client-specific manifests for Cursor and Claude Code
assets/logo.png, assets/icon.png	Listing logo with the wordmark, and the mark alone for small sizes
scripts/package-openai.sh	Builds the ZIP for the OpenAI plugin portal, whose listing is read from extensions.com.openai in plugin.json

Links

• SEO MCP landing page
• Documentation
• Support: [email protected]