MCP Integration

Control your Superblog using AI assistants that support the Model Context Protocol (MCP), such as Claude Code, Claude Desktop, Codex, and other MCP-compatible clients.

Prerequisites

A Superblog account with access to the blog you want to manage.
Your Superblog be on the SUPER plan.
An MCP-compatible AI client.

MCP Server URL

Use this Streamable HTTP MCP server URL:

https://write.superblog.ai/api/mcp

Claude Code

Run this in your terminal:

claude mcp add --transport http superblog https://write.superblog.ai/api/mcp

Then open Claude Code and ask:

show my superblogs

Claude will guide you through authentication if needed.

Claude Desktop

Open Settings > Connectors.
Click Add custom connector.
Enter a name (e.g., Superblog) and paste the MCP server URL:

https://write.superblog.ai/api/mcp

Click Add, then click Connect and complete the sign-in in your browser.

Once connected, start a new chat and ask:

show my superblogs

Codex CLI

Run this in your terminal:

codex mcp add superblog --url https://write.superblog.ai/api/mcp
codex mcp login superblog

Then start Codex:

codex

Inside Codex, you can check the connection with:

/mcp

Then ask:

show my superblogs

Codex Desktop

Open Settings > MCP servers.
Click to add a new MCP server and paste the MCP server URL:

https://write.superblog.ai/api/mcp

Click Authenticate and complete the sign-in in your browser.

Once it shows "Authentication complete", start a new chat and ask:

show my superblogs

Other MCP Clients

Add a remote MCP server with this URL:

https://write.superblog.ai/api/mcp

Use OAuth if your client supports it.

If your MCP client asks for an API key instead of OAuth, generate an API key from your Superblog dashboard (Dashboard > Data > Generate API Key) and send it as a bearer token:

Authorization: Bearer <api-key>

What You Can Do

Once connected, you can use natural language to manage almost everything you can do from the dashboard:

Posts and pages

Create, edit, publish, schedule, pin, and delete posts
Create, list, and delete static pages (About, Contact, etc.)
Get internal link suggestions

Content organization

Manage categories and tags
Add, update, and delete FAQs on posts (for FAQ rich results)
Create, edit, and delete redirects
Manage navigation menu items and footer sections
Upload images or reuse images from your media library

Translations

Enable or disable translation languages of your blog
Create and manage translated versions of posts

Audience and team

Moderate reader comments (approve, hide, or delete)
View captured leads and manage per-post lead capture forms
Manage authors: update profiles, reassign posts, add or remove co-authors
Manage team members: invite, change roles, or remove

Site management

Read and update site settings (name, SEO defaults, appearance, header, indexing options)
View blog traffic analytics for any date range
Connect or disconnect a custom domain, with the exact DNS records to add
Trigger deployments and check deploy status until your changes are live
Use advanced operations through the Superblog API for anything else

Pro Tip

For better results, you can also give your AI client the Superblog OpenAPI spec:

https://write.superblog.ai/api/v2/openapi.json

This helps the AI understand the full REST API surface when it needs to perform advanced operations beyond the built-in MCP tools.