@instablog/mcp-server

MCP (Model Context Protocol) server for Instablog - manage posts, audits, and content generation from Claude.

Installation

npm install -g @instablog/mcp-server

Setup

1. Create an API Key

1. Go to Instablog Dashboard
2. Click "Create API Key"
3. Copy the key (it's only shown once!)

2. Get your Site ID

Your Site ID is visible in the URL when you're on your dashboard: https://app.instablog.so/dashboard?siteId=YOUR_SITE_ID

3. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "instablog": {
      "command": "npx",
      "args": ["-y", "@instablog/mcp-server"],
      "env": {
        "INSTABLOG_API_KEY": "ib_your_api_key_here",
        "INSTABLOG_SITE_ID": "your-site-uuid-here"
      }
    }
  }
}

4. Configure Claude Code

Add to ~/.claude/settings.local.json:

{
  "mcpServers": {
    "instablog": {
      "command": "npx",
      "args": ["-y", "@instablog/mcp-server"],
      "env": {
        "INSTABLOG_API_KEY": "ib_your_api_key_here",
        "INSTABLOG_SITE_ID": "your-site-uuid-here"
      }
    }
  }
}

Restart Claude after adding the configuration.

Available Tools

Auth

| Tool | Description | |------|-------------| | instablog_auth_status | Check if API key is valid |

Sites

| Tool | Description | |------|-------------| | instablog_list_sites | List my sites | | instablog_select_site | Select active site | | instablog_get_site | Get selected site details |

Posts

| Tool | Description | |------|-------------| | instablog_list_posts | List posts (paginated) | | instablog_list_all_posts | Get ALL posts | | instablog_get_post | Get post details (with HTML content) | | instablog_create_post | Create a post | | instablog_update_post | Update a post | | instablog_update_post_faq | Patch post FAQ items | | instablog_delete_post | Delete a post | | instablog_set_post_tags | Set post tags |

Tags & Categories

| Tool | Description | |------|-------------| | instablog_list_tags | List tags | | instablog_list_all_tags | Get all tags | | instablog_create_tag | Create a tag | | instablog_update_tag | Update a tag (name, description, SEO) | | instablog_list_categories | List categories | | instablog_list_all_categories | Get all categories | | instablog_create_category | Create a category | | instablog_update_category | Update a category | | instablog_generate_categories | Generate categories via AI |

Topics (Article Ideas)

| Tool | Description | |------|-------------| | instablog_list_topics | List topics | | instablog_list_all_topics | Get all topics | | instablog_get_topic | Get topic details | | instablog_create_topic | Create a topic | | instablog_update_topic | Update a topic | | instablog_delete_topic | Delete a topic | | instablog_generate_topics | Generate topics via AI/competitors/news | | instablog_generate_post_from_topic | Create article from topic | | instablog_clear_all_topics | Delete all topics |

Content Generation

| Tool | Description | |------|-------------| | instablog_generate_post_content | Start AI generation | | instablog_generation_status | Check generation status | | instablog_stop_generation | Stop generation | | instablog_force_stop_generation | Force stop generation |

Audit

| Tool | Description | |------|-------------| | instablog_audit_post | Audit an article | | instablog_get_post_score | Get dimensional score | | instablog_fix_audit_issues | Auto-fix issues | | instablog_rollback_audit_fixes | Rollback fixes | | instablog_bulk_audit | Bulk audit | | instablog_get_audit_metrics | Get global metrics |

Usage Examples

Review all articles for duplicates

List all my articles and analyze if any have similar titles or content

Check SEO for all articles

List all my published articles and verify each has a meta description,
meta title, and correct headings

Add SEO metadata to tags/categories

List all my categories and add a description and meta description
for those that don't have one, following SEO best practices

Audit and fix articles

Audit all my published articles and apply automatic fixes
for detected issues

Generate topics and create articles

Generate 10 article ideas about "productivity" then create the corresponding articles

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | INSTABLOG_API_URL | API URL | https://api.instablog.so | | INSTABLOG_API_KEY | API key (required) | - | | INSTABLOG_SITE_ID | Default site ID | - |

API Keys

API keys:

• Start with ib_
• Don't expire (unless configured)
• Can be revoked anytime
• Are stored hashed (SHA-256) server-side

License

MIT