<p align="center"> <img src="logo.png" width="96" alt="Blawgy" /> </p>

Blawgy MCP server

Run your blog from Claude, ChatGPT, Cursor or your own agent.

Blawgy researches keywords, writes SEO articles and publishes them to your site (WordPress, Shopify, Webflow, Wix, Framer, Ghost, Duda or your own API) on a schedule. This MCP server gives an AI agent everything the dashboard can do. Read your Search Console traffic, run keyword research, build and reorder the content plan, write and edit articles, draft and approve updates to live posts, change images, products, locations and settings, manage guardrails, webhooks and your team.

This repo holds the public listing (README, server.json, logo). The server itself runs inside Blawgy and is not open source.

Endpoint https://app.blawgy.com/mcp (Streamable HTTP) Auth OAuth 2.1 with PKCE and dynamic client registration, or an API key as a bearer token Plans every paid Blawgy plan, including clients of white-label partners Docs blawgy.com/mcp and the help article

Connect

Claude (web, desktop, mobile)

Customize, then Connectors, then Add custom connector. Name it Blawgy, paste the server URL, press Connect and sign in with your Blawgy account. Pick the sites and whether the connection can write. On Team and Enterprise plans an owner adds it under Organization settings. To use an API key instead, paste Authorization and Bearer <key> under Request headers.

Claude Code

claude mcp add --transport http blawgy https://app.blawgy.com/mcp
claude mcp login blawgy     # or run /mcp inside a session

With an API key, no sign-in needed

claude mcp add --transport http blawgy https://app.blawgy.com/mcp \
  --header "Authorization: Bearer blk_live_..."

Shared with your repo in .mcp.json (--scope project)

{
  "mcpServers": {
    "blawgy": {
      "type": "http",
      "url": "https://app.blawgy.com/mcp",
      "headers": { "Authorization": "Bearer ${BLAWGY_API_KEY}" }
    }
  }
}

ChatGPT

Settings, then Connectors, then Advanced settings, turn on Developer mode, press Create. Name it Blawgy, paste the server URL, choose OAuth, sign in. ChatGPT only supports OAuth, so keys do not work there. Developer mode on Plus and Pro is read only. Writing, publishing and settings changes need a Business, Enterprise or Edu workspace with Developer mode enabled by an admin.

Cursor

.cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Leave out headers and Cursor prompts you to sign in.

{
  "mcpServers": {
    "blawgy": { "url": "https://app.blawgy.com/mcp" }
  }
}

With an API key

{
  "mcpServers": {
    "blawgy": {
      "url": "https://app.blawgy.com/mcp",
      "headers": { "Authorization": "Bearer ${env:BLAWGY_API_KEY}" }
    }
  }
}

VS Code and GitHub Copilot

.vscode/mcp.json, or run MCP: Add Server from the command palette.

{
  "inputs": [
    { "type": "promptString", "id": "blawgy-key", "description": "Blawgy API key", "password": true }
  ],
  "servers": {
    "blawgy": {
      "type": "http",
      "url": "https://app.blawgy.com/mcp",
      "headers": { "Authorization": "Bearer ${input:blawgy-key}" }
    }
  }
}

Drop inputs and headers to sign in with OAuth instead.

Windsurf (Devin Desktop)

~/.config/devin/mcp_config.json (Windows %APPDATA%\devin\mcp_config.json), or Cascade's menu, Open MCP config file.

{
  "mcpServers": {
    "blawgy": {
      "serverUrl": "https://app.blawgy.com/mcp",
      "headers": { "Authorization": "Bearer blk_live_..." }
    }
  }
}

Gemini CLI

gemini mcp add --transport http blawgy https://app.blawgy.com/mcp
/mcp auth blawgy

or with a key, gemini mcp add --transport http --header "Authorization: Bearer blk_live_..." blawgy https://app.blawgy.com/mcp.

Codex CLI

codex mcp add blawgy --url https://app.blawgy.com/mcp --bearer-token-env-var BLAWGY_API_KEY

or codex mcp add blawgy --url https://app.blawgy.com/mcp followed by codex mcp login blawgy for OAuth.

Gemini CLI extension

This repo is also a Gemini CLI extension (gemini-extension.json), so one command installs it with OAuth sign-in.

gemini extensions install https://github.com/adamgusky/blawgy-mcp

Cline

cline mcp install blawgy --transport http https://app.blawgy.com/mcp

Clients that only speak stdio can bridge with npx -y mcp-remote https://app.blawgy.com/mcp. See llms-install.md.

One-click links

• Cursor cursor://anysphere.cursor-deeplink/mcp/install?name=blawgy&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcHAuYmxhd2d5LmNvbS9tY3AifQ==
• VS Code vscode:mcp/install?%7B%22name%22%3A%22blawgy%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.blawgy.com%2Fmcp%22%7D

Your own agent

Create a key in Settings, AI agents. Choose its reach (one site, all your sites, or every client site if you are a partner) and whether it can write. The key is shown once.

TypeScript SDK

import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';

const client = new Client({ name: 'my-agent', version: '1.0.0' });
const transport = new StreamableHTTPClientTransport(new URL('https://app.blawgy.com/mcp'), {
  requestInit: { headers: { Authorization: `Bearer ${process.env.BLAWGY_API_KEY}` } },
});
await client.connect(transport);
const { tools } = await client.listTools();

Claude API (MCP connector, beta header anthropic-beta: mcp-client-2025-11-20)

"mcp_servers": [
  { "type": "url", "url": "https://app.blawgy.com/mcp", "name": "blawgy", "authorization_token": "blk_live_..." }
],
"tools": [{ "type": "mcp_toolset", "mcp_server_name": "blawgy" }]

OpenAI Agents SDK (Python)

MCPServerStreamableHttp(params={
    "url": "https://app.blawgy.com/mcp",
    "headers": {"Authorization": f"Bearer {os.environ['BLAWGY_API_KEY']}"},
})

What you can ask

• What grew and what slipped on my blog in the last 28 days, and why?
• Find low-difficulty keywords about soy candle care and add the best five to the plan.
• Write an article on fixing candle tunnelling and send it to WordPress as a draft.
• Which published posts are losing clicks? Draft an update for the worst one and show me the diff.
• Is yesterday's post indexed by Google and Bing yet? Recheck it.
• Add a guardrail that we never quote prices, and apply it to every site I run.
• Switch all my client sites to three posts a week and reschedule anything overdue.

Tools

Every site tool takes a site argument (the domain). The server's instructions tell the agent which sites the credential can reach. Slow work (research, writing, scans, syncs) returns a job id immediately and a status tool reports progress.

<!-- tools:start -->

123 tools. "confirm" means the agent must confirm before the call runs. "Pro+" tools are hidden on lower plans.

Content plan

| Tool | What it does | Access | |---|---|---| | get_plan | Get content plan | read | | generate_plan | Generate or refill the plan | write | | add_to_plan | Add to plan | write | | update_plan_entry | Edit a plan entry | write | | remove_plan_entry | Remove a plan entry | confirm | | reschedule_overdue | Reschedule overdue entries | write | | pause_autopilot | Pause the plan | write | | resume_autopilot | Resume the plan | write | | update_plan_config | Update plan settings | write | | dismiss_topic | Hide a research topic | write | | exclude_topic | Exclude a topic or keyword | write | | accept_plan_suggestion | Accept a suggested topic | write | | dismiss_plan_suggestion | Dismiss a suggested topic | write |

Articles

| Tool | What it does | Access | |---|---|---| | list_articles | List articles | read | | get_article | Get an article | read | | write_article_now | Write article(s) now | write | | update_article | Edit an article | write | | reschedule_article | Change an article's publish date | write | | publish_draft | Publish a CMS draft | confirm | | republish_article | Republish an article | confirm | | delete_article | Delete an article | confirm | | release_held_article | Release a held article | confirm | | get_article_preview_url | Get a preview link | read |

Article builder

| Tool | What it does | Access | |---|---|---| | generate_titles | Builder step 1: titles | write | | generate_outline | Builder step 2: outline | write | | regenerate_outline | Builder: redo the outline | write | | write_from_outline | Builder step 3: write the article | write | | regenerate_section | Builder: rewrite one section | write | | remix_from_urls | Remix an existing article | write | | list_builder_drafts | List builder drafts | read | | get_builder_draft | Get a builder draft | read | | save_builder_draft | Save a builder draft | write | | delete_builder_draft | Delete a builder draft | confirm | | publish_article_from_builder | Save and publish a builder article | confirm |

Smart updates

| Tool | What it does | Access | |---|---|---| | list_update_opportunities | List page updates | read | | check_for_updates | Find new update opportunities | write, Pro+ | | draft_update | Write an update draft | write, Pro+ | | edit_update_draft | Edit an update draft | write, Pro+ | | approve_update | Approve and publish an update | confirm, Pro+ | | dismiss_update | Dismiss an update | write, Pro+ | | revert_update | Revert a published update | confirm, Pro+ | | set_updates_autopilot | Turn updates autopilot on or off | write, Pro+ |

Images and photo bank

| Tool | What it does | Access | |---|---|---| | list_image_posts | List posts whose image can be changed | read | | get_post_image | Get a post's image panel | read | | generate_post_image | Generate a new image for a post | write, Pro | | upload_post_image | Upload your own image for a post | write, Pro | | apply_post_image | Apply a candidate as the post's image | write | | revert_post_image | Revert a post's image | confirm | | get_image_preview_usage | Image preview allowance and sample titles | read | | preview_image_style | Render a sample image in a style | write | | extract_brand_colors | Read brand colours off the website | write | | list_photos | List the product photo bank | read | | get_photo_candidates | Products that can be added to the photo bank | read | | add_photo_from_product | Add a catalogue product to the photo bank | write | | add_photo | Upload a product photo to the bank | write | | update_photo | Edit a photo bank entry | write | | remove_photo_background | Remove a photo's background | write | | restore_photo_original | Restore a photo's original upload | write | | duplicate_photo | Add another look of a product | write | | delete_photo | Delete a photo from the bank | confirm |

Products

| Tool | What it does | Access | |---|---|---| | list_products | List products | read | | get_product | Get one product | read | | sync_products | Sync products from Shopify now | write | | get_product_sync_status | Product sync settings and status | read | | update_product_sync_settings | Change automatic product sync | write | | add_product | Add a product by hand | write | | update_product | Edit a product | write | | hide_product | Hide a product from articles | write | | unhide_product | Unhide a product | write | | delete_product | Delete (archive) a product | confirm | | get_dutchie_status | Dutchie POS connection status | read | | connect_dutchie | Connect a Dutchie location | write | | sync_dutchie | Pull the Dutchie menu now | write | | remove_dutchie_location | Disconnect a Dutchie location | confirm |

Location pages

| Tool | What it does | Access | |---|---|---| | list_business_locations | List business locati