newsjack-mcp

Standalone Model Context Protocol (MCP) server and CLI for NewsJack — real-time music industry news intelligence, custom-voice drafting, and editorial roasts.

Installation

Run directly with npx or install globally:

# Run directly with npx
npx newsjack-mcp mcp

# Or install globally
npm install -g newsjack-mcp

Quick Start: Claude Desktop & Claude Code

Claude Code

NewsJack ships project-level .mcp.json support. You can also add it via CLI:

claude mcp add newsjack -- npx -y newsjack-mcp mcp

Claude Desktop

Add this entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "newsjack": {
      "command": "npx",
      "args": ["-y", "newsjack-mcp", "mcp"],
      "env": {
        "NEWSJACK_API_KEY": "nj_ak_your_key_here"
      }
    }
  }
}

Terminal CLI Usage

# 1. List top scored stories
newsjack stories --min-relevance 0.6 --limit 5

# 2. View story details
newsjack story <story-id>

# 3. Draft social content for a story (twitter, linkedin, newsletter)
newsjack generate <story-id> linkedin --conviction spicy

# 4. Roast a draft against the current news cycle
newsjack roast "Big news: our single is dropping this Friday!" --platform twitter

MCP Tools Exposed (21 Tools)

1. list_stories: Search and list live music news stories with relevance scores.
2. get_story: Retrieve full metadata and summary for a single story.
3. generate_post: Generate tailored social drafts with tone and conviction controls.
4. generate_post_dry_run: Preview post drafts without incrementing generation counters.
5. roast_post: Editorial critique against active 72-hour news cycles.
6. get_voice_profile: Inspect active voice profile and constraints.
7. set_voice_profile: Configure custom brand voice samples and avoid-phrases.
8. get_generation_config: Get generation defaults and platform preferences.
9. set_generation_config: Update default platforms and conviction axes.
10. list_sources: List monitored RSS and publication sources.
11. add_source: Queue custom RSS feed for monitoring.
12. remove_source: Remove custom RSS feed.
13. toggle_source: Pause or resume feed monitoring.
14. disable_global_source: Mute built-in publications.
15. enable_global_source: Unmute built-in publications.
16. list_scheduled: Inspect queued social posts.
17. schedule_post: Queue post for scheduled publication.
18. cancel_scheduled: Cancel scheduled post.
19. export_to_tap: Export trending angle into Total Audio Promo campaign desk.
20. get_usage_metrics: Check tier limits and quota reset dates.
21. get_service_health: Monitor service status and AI failover diagnostics.

License

MIT © Total Audio Promo / Chris Schofield