Bloghunch MCP Server
OfficialThis MCP server connects your AI assistant to Bloghunch for content creation, analytics, subscriber management, and AI-powered SEO/distribution workflows.
Analytics & Posts: Get publication stats, list/filter posts, read full post content, manually create drafts, update drafts, and list subscribers.
AI Content Generation (requires AI Studio): Generate complete posts from a topic, brainstorm post angles, create SEO-optimized titles, and produce SEO briefs.
Distribution & SEO: Generate Twitter/LinkedIn/newsletter assets for existing posts and trigger GSC-powered topic discovery to find high-potential SEO opportunities.
Flexible Deployment: Works over STDIO for local assistants (Claude Desktop, Cursor, Windsurf) or HTTP for remote assistants like ChatGPT.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bloghunch MCP Server create a post about the future of remote work"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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? |
| Analytics snapshot (pageviews, subscribers, posts) | No |
| List posts with status/keyword filter | No |
| Read full content and details of a single post | No |
| Create a post manually as a draft | No |
| Update an existing draft post | No |
| List newsletter subscribers | No |
| Complete AI generation via topic (SEO brief → RAG → Draft) | Yes |
| Brainstorm 5 post angles for any topic | Yes |
| Generate 5 SEO-optimized title suggestions | Yes |
| Generate a comprehensive SEO brief | Yes |
| Generate Twitter, LinkedIn, newsletter assets for a post | Yes |
| Trigger GSC-powered SEO topic discovery | Yes |
| 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 .envFill in:
BLOGHUNCH_API_KEY=bh_live_xxxxxxxxxxxx
BLOGHUNCH_SUBDOMAIN=your-subdomain
BLOGHUNCH_API_URL=https://api.bloghunch.com/api/v1Get your API key from Settings → Developers.
2. Build
npm install
npm run build3. 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 build2. 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/v13. Start the server
npm start
# or: TRANSPORT=http node dist/index.js4. Connect in ChatGPT
Open ChatGPT → Settings → Apps & Connectors → Advanced settings → enable Developer Mode
Click Create connector
Enter name:
Bloghunchand URL:https://mcp.yourdomain.comSelect OAuth as auth method
Click Connect → log in with your Bloghunch API key
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 toolsbh_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Connect AI assistants to Appimate's Business Agent Tools and Services.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Run your company blog for SEO and AI search from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to your Brivvy workspace so they can use your brand voices, templates, and glossary for on-brand content.MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Purefeed for access to AI-curated Twitter/X feeds, signals, semantic search, and post creation.8 npm1MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to publish and manage blog posts on Misar.Blog, including drafts, series, AI content generation, and analytics.34268 npm1MIT
- AlicenseNot gradedqualityBmaintenanceLets AI assistants manage a self-hosted content hub: create, edit, publish, and update articles across nine platforms, refresh account article lists, and sync changes through natural language.MIT