blogr.ai

Docs

VS Code MCP server for GitHub Copilot

Add blogr to VS Code and use it from GitHub Copilot agent mode: rankings, the content calendar and drafts, next to your website's code.

How it works

GitHub Copilot in VS Code can call MCP servers in agent mode. Add blogr once and Copilot can look up your articles, topical map and Search Console numbers while it works in your repository. VS Code handles the sign-in itself: it finds blogr's OAuth server, registers, and opens the consent screen in your browser.

Copilot acts as you, with your team role on each website, and can change only what your role allows.

What you need

  • A blogr account. Each website's data is available while its owner has an active plan or trial.
  • VS Code with GitHub Copilot. On Copilot Business and Enterprise, your organization must allow MCP servers.

Connect VS Code

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose HTTP, paste this URL, and name the server blogr:
https://blogr.ai/mcp
  1. Allow VS Code to sign in when it asks. blogr opens in your browser, where you choose Allow access.
  2. Open Copilot Chat in Agent mode and ask "Using blogr, list my websites."

To share the setup with your team, commit it as .vscode/mcp.json. Each person signs in with their own blogr account:

{
  "servers": {
    "blogr": {
      "type": "http",
      "url": "https://blogr.ai/mcp"
    }
  }
}

Things to ask Copilot

  • "List the blogr articles published this month and add them to our changelog page."
  • "Which topical map pages are still missing from this site? Open an issue for each."
  • "Show my top ten queries by clicks for the last 28 days."
  • "Approve the waiting titles about pricing and schedule them for next week."

What Copilot can do

Copilot reads without asking. Every tool that changes something is marked as a write, so Copilot asks you to confirm before it runs.

Tool What it does Changes data
list_websitesYour websites, your role on each, and whether each has a plan, a topical map and Search Console.No
get_website_overviewArticle counts by status, what is scheduled next, failures, map coverage and the monthly allowance left.No
list_articlesArticles by status, with dates and live links.No
get_articleOne article in full: the Markdown body, SEO title, meta description, categories and tags.No
get_topical_mapThe map by silo, then each page with its query, search volume, difficulty and current rank.No
get_performanceSearch Console clicks, impressions, CTR and position for 7, 28 or 90 days, with top queries and pages.No
get_article_impactHow recent articles are moving in Google week over week.No
list_opportunitiesThe SEO opportunities blogr found in your Search Console data.No
get_usageYour plan and this month's article allowance.No
approve_titlesApproves titles onto your publishing schedule, one per slot, the same as the approval tray.Yes
decline_titlesDeclines titles that are not written yet. You can approve them again later.Yes
add_article_ideaAdds your own title on the next open slot, like Add title in the app.Yes
reschedule_articleMoves a scheduled article to another day and pins it there.Yes
update_articleRenames a title, or edits a written draft's title, body, SEO fields, categories and tags.Yes

What Copilot cannot do

  • Publish, delete or archive articles. Publishing stays in blogr, so nothing reaches your live site from Copilot.
  • Start writing an article early. Approved titles are written on their scheduled day, within your monthly allowance.
  • See or change billing, website settings, team members, or your publishing connection and its tokens.

An edit to a published article is saved in blogr. The live page changes the next time you publish that article from blogr.

Team roles

Copilot follows your role on each website. Viewers can read everything they see in the app, and Copilot cannot change anything for them. Editors and admins can approve, decline, add, reschedule and edit through Copilot. Owners can do all of it.

Limits

  • 120 requests per minute per account, across every assistant you connect.
  • 200 changes per account per hour.
  • 25 titles added through an assistant per website per day.

Past a limit, Copilot gets a message saying so and can try again later. Nothing you do in the app counts toward these limits.

Your data

  • Copilot receives only what you ask for: your websites, articles, topical map, Search Console performance and opportunities.
  • blogr never sees your Copilot conversations. For each request it records which tool ran, on which website, whether it worked and how long it took, and deletes that record after 90 days.
  • Copilot signs in with its own access token, which never includes your password. To disconnect, run MCP: List Servers in VS Code and remove blogr, then sign blogr out under Accounts.

Once Copilot receives data from blogr, GitHub Copilot handles it under its privacy policy. Read blogr's own privacy policy for what we store.

Troubleshooting

  • Copilot never calls blogr: MCP tools only run in Agent mode. Check blogr is ticked in the tools picker.
  • MCP: Add Server is missing: your organization may have switched MCP off in Copilot policies.
  • "blogr needs an active plan or trial": start a plan or trial on the account that owns the website.
  • "Your role does not allow this": ask the website owner to give you the Editor or Admin role.

Questions

Does blogr work with GitHub Copilot?

Yes. Add https://blogr.ai/mcp as an HTTP MCP server in VS Code and use it from Copilot agent mode.

Can my whole team use the same setup?

Yes. Commit .vscode/mcp.json to the repository. Each person signs in to blogr with their own account and gets their own role.

Can Copilot publish articles?

No. Copilot can approve, decline, add, reschedule and edit articles. Publishing stays in blogr.