Skip to main content
Glama
Bloghunch MCP Server

Bloghunch MCP Server

Official
by bloghunch

Bloghunch MCP Server

Connect your AI assistant directly to your Bloghunch publication to automate content creation, analytics, and distribution.

Supports two transport modes:

  • STDIO — Claude Desktop, Cursor, Windsurf, Zed, VS Code (local, no hosting needed)

  • HTTP — ChatGPT (remote, requires public HTTPS URL)


Tools Available

Tool

Description

AI Studio Required?

bh_get_stats

Analytics snapshot (pageviews, subscribers, posts)

No

bh_list_posts

List posts with status/keyword filter

No

bh_get_post

Read full content and details of a single post

No

bh_create_post

Create a post manually as a draft

No

bh_update_post

Update an existing draft post

No

bh_list_subscribers

List newsletter subscribers

No

bh_generate_post

Complete AI generation via topic (SEO brief → RAG → Draft)

Yes

bh_generate_ideas

Brainstorm 5 post angles for any topic

Yes

bh_generate_titles

Generate 5 SEO-optimized title suggestions

Yes

bh_generate_seo_brief

Generate a comprehensive SEO brief

Yes

bh_social_echo

Generate Twitter, LinkedIn, newsletter assets for a post

Yes

bh_discover_topics

Trigger GSC-powered SEO topic discovery

Yes

bh_get_topic_discoveries

List discovered topic opportunities

Yes

Note on LTD Users: Tools marked with "AI Studio Required" will only work if the user has unlocked the AI Studio Add-on and configured their own Gemini or OpenAI keys.


Related MCP server: Purefeed MCP Server

Installation — Claude Desktop, Cursor, Windsurf (STDIO)

1. Configure .env

cp .env.example .env

Fill in:

BLOGHUNCH_API_KEY=bh_live_xxxxxxxxxxxx
BLOGHUNCH_SUBDOMAIN=your-subdomain
BLOGHUNCH_API_URL=https://api.bloghunch.com/api/v1

Get your API key from Settings → Developers.

2. Build

npm install
npm run build

3. Client Configuration

Add the following to your AI client's MCP configuration file. Replace /absolute/path/to/mcp-server with the actual path on your machine.

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json): For Cursor (Cursor Settings → Features → MCP): For Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "bloghunch": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "BLOGHUNCH_API_KEY": "bh_live_xxxxxxxxxxxx",
        "BLOGHUNCH_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Installation — ChatGPT (HTTP mode)

ChatGPT requires a publicly hosted HTTPS server. Run this on your VPS behind Nginx/Caddy.

1. Build

npm install
npm run build

2. Set environment variables on your server

export TRANSPORT=http
export PORT=3001
export MCP_SERVER_URL=https://mcp.yourdomain.com   # public HTTPS URL
export BLOGHUNCH_API_URL=https://api.bloghunch.com/api/v1

3. Start the server

npm start
# or: TRANSPORT=http node dist/index.js

4. Connect in ChatGPT

  1. Open ChatGPT → Settings → Apps & Connectors → Advanced settings → enable Developer Mode

  2. Click Create connector

  3. Enter name: Bloghunch and URL: https://mcp.yourdomain.com

  4. Select OAuth as auth method

  5. Click Connect → log in with your Bloghunch API key

  6. Done ✅ — ChatGPT can now use all Bloghunch tools


Local Development

# STDIO mode
npm run dev

# HTTP mode (test locally)
npm run dev:http

© 2026 Bloghunch — AI-native blogging platform.

Available Tools

8 tools
bh_create_postA

Create a blog post. Provide 'topic' for high-quality AI generation (SEO brief → RAG evidence → BullMQ job). Returns a receipt immediately; post appears in dashboard within minutes.

Inputs: title, topic, status, content, +3 more.

bh_discover_topicsC

Trigger AI analysis of Google Search Console data to find high-potential SEO topic opportunities.

Inputs: niche (required), contentGoals (required), targetAudience (required).

bh_generate_ideasB

Brainstorm 5 unique blog post angles for a topic using AI.

Inputs: topic (required).

bh_get_statsA

Get analytics summary (pageviews, subscribers, posts) for the Bloghunch publication.

Inputs: no named parameters.

bh_get_topic_discoveriesB

List SEO-driven topic opportunities discovered by Bloghunch.

Inputs: status, priority.

bh_list_postsB

List blog posts. Optionally filter by status or keyword.

Inputs: status, keyword.

bh_list_subscribersA

List newsletter subscribers for the publication.

Inputs: no named parameters.

bh_social_echoB

Generate Twitter thread, LinkedIn post, and newsletter teaser for an existing blog post.

Inputs: postId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource: stats, posts, ideas, subscribers, social echo, and topic discovery. The paired trigger/list tools for topic discoveries are clearly differentiated by their verb prefixes.

    Naming Consistency4/5

    All tools share the 'bh_' prefix and use snake_case, mostly with verb_noun structure. 'bh_social_echo' deviates from the verb-first pattern, and 'get_' vs 'list_' is slightly inconsistent, but the overall convention is predictable.

    Tool Count5/5

    Eight tools is well-scoped for a blog publication server covering analytics, content creation, subscriber management, social sharing, and SEO discovery. No bloat or redundancy.

    Completeness4/5

    The core workflows of creating posts, listing subscribers, gathering stats, and discovering topics are covered. Missing post update/delete and a direct 'get post' operation are minor gaps, as external dashboards likely handle those.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers