@Houtini/Contentmarketingideas

npm version License: MIT

The MCP server for Content Marketing Ideas — the editorial copilot I built because I was tired of the same content research loop. You read a lot, you notice patterns, you get ideas, you write. The reading and pattern-spotting is the slow part, and most of it is mechanical.

This server pulls all of it into Claude Desktop, Claude Code, Cursor, or any MCP client: source monitoring, editorial briefs, voice-matched article drafts, RAG corpus search, Google Search Console data, and WordPress publishing. Around 70 tools, one npx command.

I wrote a long post about why the product exists and how I use it every day: Content Marketing Ideas — what it is, how I built it, and why I use it.

---

Quick Navigation

Get started | What it does | Tools reference | Configuration | Requirements

---

Get started in two minutes

Step 1: Get an account and an API key

Sign up at contentmarketingideas.co. Free tier covers five sources and weekly delivery, which is enough to wire the MCP up and try every tool. Once you're in, go to Dashboard → Account → API & MCP Server and click Generate API Key. The full key is shown once — copy it now. Keys are prefixed cr_.

Step 2: Add to your Claude Desktop config

Config file locations:

• Windows: C:\Users\{username}\AppData\Roaming\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "contentmarketingideas": {
      "command": "npx",
      "args": ["-y", "@houtini/contentmarketingideas"],
      "env": {
        "CMI_API_KEY": "cr_your_api_key_here"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Tools show up automatically. npx pulls the package on first run — no separate install needed.

Claude Code (CLI)

Claude Code uses claude mcp add rather than the desktop config file:

claude mcp add -e CMI_API_KEY=cr_your_api_key_here -s user contentmarketingideas -- npx -y @houtini/contentmarketingideas

Verify with claude mcp get contentmarketingideas — you should see Status: Connected.

Cursor / Windsurf / VS Code

Same shape, different config file. Add this block:

{
  "contentmarketingideas": {
    "command": "npx",
    "args": ["-y", "@houtini/contentmarketingideas"],
    "env": {
      "CMI_API_KEY": "cr_your_api_key_here"
    }
  }
}

Local build instead

For development, or if you'd rather not rely on npx:

git clone https://github.com/houtini-ai/contentmarketingideas-mcp
cd contentmarketingideas-mcp
npm install
npm run build

Then point your config at the local build:

{
  "mcpServers": {
    "contentmarketingideas": {
      "command": "node",
      "args": ["C:/path/to/contentmarketingideas-mcp/dist/index.js"],
      "env": {
        "CMI_API_KEY": "cr_your_api_key_here"
      }
    }
  }
}

---

What it does

Content Marketing Ideas isn't a "here's what's trending" feed. It's an editorial copilot — every brief is framed as "here's what you should write and why" rather than a data dump. The MCP exposes the same engine to Claude.

Editorial briefs from your sources

Use contentmarketingideas:list_briefs to show me this week's briefs for site-ae01a256

The product watches RSS feeds, YouTube channels, subreddits, podcasts, and news keywords for you. When something relevant lands, four signal generators (trending, decay, untapped, gap) write briefs containing a thesis, editorial play, gap analysis, suggested format, what to cover, internal link suggestions, and two alternative angles (obvious / bold / contrarian). Each brief is enriched with keyword volume, difficulty, monthly trend, People Also Ask questions, competitive landscape, entity relationships from Wikidata, and an originality score versus existing coverage.

get_brief returns the full payload — synthesis, signal sources, enrichment, momentum sparkline, the lot. brief_feedback lets you train the system from inside Claude (thumbs_up / thumbs_down / made_this / already_covered). Thumbs-down auto-archives briefs you don't want to see again.

Voice-matched article generation

Use contentmarketingideas:create_article with source_type="brief" and source_id="<brief_id>"

The web app analyses your published content with sixteen statistical analysers and produces a deterministic ~17KB writing-style guide. Article generation feeds that guide into Claude Sonnet so the output reads like you wrote it — not like an LLM. 1,300–1,800 words, full markdown, with Schema.org provenance and entity-tagged facts traceable back to the source.

generate_article queues an article for the production pipeline, regenerate_article re-runs failed jobs, get_article_provenance returns the source chain and Schema.org JSON-LD, and publish_article pushes the finished post straight to WordPress over the REST API (credentials encrypted at rest).

Topic Explorer — coverage as a map, not a list

Use contentmarketingideas:get_coverage_explore for site-ae01a256

Topics are the unit of value. The Topic Explorer assembles every entity from your last 100 briefs plus your site's core topics, then enriches each with corpus matches, GSC traffic and 28-day sparklines, search volume, competitive landscape, parent/sibling topics from Wikidata, and a lifecycle state: covered, trending, gap, declining, or emerging. get_coverage_explore returns the full clustered dataset so you can ask Claude things like "which trending topics do I have zero coverage on?" or "cluster my declining pages by parent topic and suggest refreshes."

Search Console integration

Use contentmarketingideas:gsc_growing_queries with site_id="..." and limit=20

GSC OAuth is per-site. Once connected, daily data feeds into brief generation and is queryable through the MCP: gsc_summary, gsc_queries, gsc_opportunities (high-impression, low-position), gsc_growing_queries, gsc_declining_queries, gsc_growing_pages, gsc_declining_pages, gsc_daily_summary for sparklines.

RAG corpus — your own knowledge base inside Claude

Use contentmarketingideas:search_rag with q="long-tail audience research methods" and limit=10

The corpus is human-curated by design — your own published content, the sources you follow, and URLs you add manually. No auto-crawling junk. Documents are indexed into Cloudflare Vectorize (bge-m3, 1024d) and a D1 FTS5 index for hybrid semantic + keyword search. Long structured documents get section-aware embeddings with parent_id linkage, and queries dedupe sections back to their parent doc with a small breadth bonus.

populate_corpus indexes a list of URLs, populate_site walks a sitemap, populate_youtube pulls full transcripts from a YouTube channel. list_corpus_documents, delete_corpus_document, rag_stats, and search_rag round it out. Site-scoped — sources for site A don't pollinate site B's briefs.

Source management

Use contentmarketingideas:detect_source with url="https://example.com/feed"

detect_source auto-identifies feed type (RSS, YouTube, Reddit, podcast, news) and resolves the canonical feed URL. add_source, update_source, delete_source, list_sources, get_source cover the rest. Sources are site-scoped, so a multi-site account never cross-contaminates briefs.

Pipeline triggers

Use contentmarketingideas:trigger_synthesis to generate briefs now

Don't want to wait for the cron run? trigger_ingestion runs all your sources, trigger_synthesis generates briefs from current content, trigger_profile re-runs site profile analysis (voice guide, topics, audience, content gaps). Useful for testing and for end-of-day "what came in today" runs.

Account, sites, deliveries, WordPress

Multi-site accounts are first-class. list_sites / create_site / update_site / delete_site / update_site_schedule for site management; list_account_emails / add_account_email / delete_account_email for multi-recipient delivery (Business+); get_wordpress_status / save_wordpress_credentials / delete_wordpress_credentials for publishing; list_deliveries for the email delivery audit trail.

---

Tools reference

Around 70 tools across seven groups.

Briefs

Tool	Description
list_briefs	List editorial briefs with filters (site, status, signal type, search)
get_brief	Full brief detail: synthesis, enrichment, keywords, signals, momentum
brief_feedback	Submit feedback (thumbs_up, thumbs_down, made_this, already_covered)
delete_brief	Delete a brief
generate_draft	Generate a voice-matched draft from a brief
get_draft	Get the generated draft text

Sources

Tool	Description
list_sources	List content sources, optionally filtered by site
get_source	Source details and item count
add_source	Add RSS, YouTube, Reddit, podcast, or news source
update_source	Rename or set keyword filters / tags
delete_source	Remove a source
detect_source	Auto-detect source type from URL

Articles

Tool	Description
list_articles	List articles for a site
get_article	Full article with markdown, outline, research
create_article	Create from a brief, growth item, or custom prompt
update_article	Edit title, markdown, keywords, notes
delete_article	Delete an article
generate_article	Queue an article for AI generation
regenerate_article	Re-run a failed or completed article
publish_article	Publish to WordPress
get_publish_status	Check WordPress publish status
get_article_provenance	Source attribution + Schema.org JSON-LD

RAG corpus

Tool	Description
list_corpus_documents	List indexed documents
delete_corpus_document	Remove a document
search_rag	Hybrid semantic + keyword search
rag_stats	Corpus statistics
populate_corpus	Index URLs into the corpus
populate_site	Index a site via sitemap
populate_youtube	Index YouTube channel transcripts
get_coverage	Brief-vs-corpus coverage report
get_coverage_explore	Topic Explorer data with clusters

Growth & GSC

Tool	Description
get_growth_plan	Get the cached growth plan for a site
generate_growth_plan	Generate a fresh growth plan
gsc_sync	Trigger a Search Console sync
gsc_summary	28-day performance summary
gsc_queries	Top queries with metrics
gsc_opportunities	High-impression, low-position queries
gsc_daily_summary	Daily metrics for sparklines
gsc_growing_queries	Queries gaining performance
gsc_declining_queries	Queries losing performance
gsc_growing_pages	Pages gaining performance
gsc_declining_pages	Pages losing performance

WordPress

Tool	Description
get_wordpress_status	Check connection status
save_wordpress_credentials	Connect WordPress (encrypted at rest)
delete_wordpress_credentials	Disconnect WordPress

Account, sites, pipeline

Tool	Description
get_account	Account details, plan, usage, limits
list_sites	Your sites with source/brief counts
create_site	Add a new site
update_site	Update site name / URL
delete_site	Remove a site (cascades sources, briefs)
update_site_schedule	Set delivery frequency and hour
list_account_emails	Delivery email recipients
add_account_email	Add an email recipient
delete_account_email	Remove an email recipient
get_profile	Site voice profile
trigger_profile	Generate / refresh site profile
trigger_ingestion	Run source ingestion now
trigger_synthesis	Generate briefs from current content
list_deliveries	Email delivery history

---

Configuration reference

Variable	Required	Default	Description
CMI_API_KEY	Yes	—	Your API key from Dashboard → Account → API & MCP Server (starts with cr_)
CMI_API_URL	No	https://api.contentmarketingideas.co	API base URL — override only for self-hosted or staging

---

Security

Your API key authenticates as your account and your account only. Every request is server-side authenticated against users.api_key (hashed). The API enforces ownership checks on every resource: you cannot read, modify, or delete another user's data even by guessing IDs. No X-User-ID impersonation header exists.

If a key leaks, revoke it from Dashboard → Account → API & MCP Server and generate a new one — old keys are immediately rejected.

---

Plans and limits

The MCP itself is free and open source. The platform behind it has tiered limits:

Plan	Sources	Sites	Frequency	Articles / month
Free	5	1	Weekly	0
Pro	25	1	Daily	10
Business	50	5	Daily	25
Publisher	100	10	Daily	50

Free is enough to wire up the MCP and try every tool against real data. Pro unlocks daily delivery, voice-matched drafts, growth plans, and keyword analytics. Business adds multi-site, WordPress publishing, and competitor intel. Pricing is at contentmarketingideas.co/pricing.

---

Requirements

• Node.js 18+
• A Content Marketing Ideas account (free tier works) and an API key
• An MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, or any other MCP host

---

Links

• Product: contentmarketingideas.co
• Why I built it: houtini.com — Content Marketing Ideas: what it is, how I built it, and why I use it every day
• npm: @houtini/contentmarketingideas
• MCP spec: modelcontextprotocol.io

Licence

MIT