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

SSE Endpoint:GET https://newsjack.cc/api/mcp/sse

CLI Package:npx newsjack-mcp mcp

storiesRead-OnlyIdempotent

list_stories

List Music News Stories

Search and list live music industry news stories scored by relevance to artist topics. Returns an array of scored headlines, source names, and summaries. Does NOT generate posts — use generate_post for drafting.

Required OAuth / API Scopes

read:stories

Input Parameters

Parameter	Type	Requirement	Description
limit	number	optional (def: 10)	Maximum number of stories to return (1-50, default 10).
min_relevance	number	optional (def: 0.4)	Minimum relevance score threshold between 0.0 and 1.0 (default 0.4).
sort_by	string	optional (def: 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 & 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.