Model Context Protocol Reference

Self-contained specifications, parameter schemas, store annotations, and JSON-RPC payloads for all NewsJack MCP tools. Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, and OpenAI Custom GPTs.

HTTP Endpoint:POST https://newsjack.cc/api/mcp

CLI Package:npx newsjack-mcp mcp

What these docs cover

This is the complete reference for all 21 NewsJack MCP tools. Every tool page lists its purpose, its full parameter schema with types and required fields, its annotations, and a worked JSON-RPC request and response you can copy straight into a client. The tools fall into a handful of groups: story scanning and retrieval against the live music news cycle, relevance scoring, brand voice profiling, post drafting, and editorial roasting of a draft before it ships.

They are written for developers wiring NewsJack into Claude Desktop, Claude Code, Cursor, Windsurf or a custom agent runtime, and for anyone auditing what the server can do before granting it access. Connect over HTTP at POST https://newsjack.cc/api/mcp, or run the CLI with npx newsjack-mcp mcp. The MCP landing page has a one-click configuration generator if you want a working config before reading the schemas.

storiesRead onlyIdempotent

list_stories

List Music News Stories

Search the authenticated account’s music-industry Stories by relevance, recency, and industry.

Required OAuth / API scopes

read:stories

Input parameters

Parameter	Type	Requirement	Description
limit	number	optional (default: 10)	Maximum number of stories to return (1-50, default 10).
min_relevance	number	optional (default: 0.4)	Minimum relevance score threshold between 0.0 and 1.0 (default 0.4).
sort_by	string	optional (default: relevance)	Sort order: 'relevance' (best matches first) or 'recency' (newest first).
category	string	optional	Optional topic filter, e.g. 'streaming', 'touring', 'ai', 'copyright'.

JSON-RPC request example

{
  "jsonrpc": "2.0",
  "id": "req_001",
  "method": "tools/call",
  "params": {
    "name": "list_stories",
    "arguments": {
      "limit": 5,
      "min_relevance": 0.5,
      "sort_by": "relevance"
    }
  }
}

cURL command

curl -X POST https://newsjack.cc/api/mcp \
+  -H "Authorization: Bearer nj_ak_your_key_here" \
+  -H "Content-Type: application/json" \
+  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_stories",
    "arguments": {
      "limit": 5,
      "min_relevance": 0.5,
      "sort_by": "relevance"
    }
  }
}'

Error handling and recovery

Missing or unauthenticated bearer token➔ Provide a valid Bearer nj_ak_* key or OAuth access token in Authorization header.

Invalid parameter schema types➔ Ensure all required fields match the specified types in parameters table.