list_stories

Discover BedrockNews stories with GRIN-aware filters. Filter by verdict ('extractive' | 'mixed' | 'generative'), plumb range (0-100 analytical-clarity score), editorialMode ('grin' news/politics | 'culture' | 'research' | 'ledger'), category (see list_categories), date window (since/before, ISO 8601), or a title search (substring match on titles, not full text). Sorted newest first; paginated via cursor. Returns compact story briefs — use get_article for full analysis.

Parameters10

query	string	optional	Optional title search (substring match)
category	string	optional	Category id filter (e.g. 'politics', 'research')
verdict	string	optional	GRIN verdict filter, derived from grinScores.extractive
editorialMode	string	optional	Filter to one editorial framework
plumbMin	number	optional	Minimum plumb (0-100)
plumbMax	number	optional	Maximum plumb (0-100)
since	string	optional	Only stories published at/after this ISO 8601 date
before	string	optional	Only stories published before this ISO 8601 date
cursor	string	optional	Opaque pagination cursor from a previous call
limit	number	optional	Max results (default 15, max 50)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional title search (substring match)"
    },
    "category": {
      "type": "string",
      "description": "Category id filter (e.g. 'politics', 'research')"
    },
    "verdict": {
      "type": "string",
      "enum": [
        "extractive",
        "mixed",
        "generative"
      ],
      "description": "GRIN verdict filter, derived from grinScores.extractive"
    },
    "editorialMode": {
      "type": "string",
      "enum": [
        "grin",
        "culture",
        "research",
        "ledger"
      ],
      "description": "Filter to one editorial framework"
    },
    "plumbMin": {
      "type": "number",
      "description": "Minimum plumb (0-100)"
    },
    "plumbMax": {
      "type": "number",
      "description": "Maximum plumb (0-100)"
    },
    "since": {
      "type": "string",
      "description": "Only stories published at/after this ISO 8601 date"
    },
    "before": {
      "type": "string",
      "description": "Only stories published before this ISO 8601 date"
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from a previous call"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 15, max 50)"
    }
  }
}

get_article

Fetch one BedrockNews story by id. Returns the transformed article plus its full structured analysis (GRIN scores, extraction graph, key stats, trajectory, what-to-watch). Pass fields:'grin' to get just the analysis payload without the heavy body text. Story ids contain slashes (e.g. 'ledger/2026/apr/06/iran-war-math-doesnt-work') — pass them verbatim.

Parameters2

id	string	required	The story id, verbatim (ids contain slashes)
fields	string	optional	Optional projection: 'grin' for the analysis-only view

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The story id, verbatim (ids contain slashes)"
    },
    "fields": {
      "type": "string",
      "description": "Optional projection: 'grin' for the analysis-only view"
    }
  },
  "required": [
    "id"
  ]
}

get_extraction_graph

Return a story's extraction map as a real graph — nodes + edges data, not a picture. This is the load-bearing artifact for agents: re-render it in any style, or analyze who extracts value from whom. 'Not found' can mean the story has no graph (culture/research modes, or older transforms).

Parameters1

id

string

required

The story id, verbatim (ids contain slashes)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The story id, verbatim (ids contain slashes)"
    }
  },
  "required": [
    "id"
  ]
}

get_related

Related BedrockNews stories for a given article — same section, ranked by editorial-mode match, plumb, source affinity, and recency.

Parameters2

id	string	required	The source story id
limit	number	optional	Max related stories (default 4, max 12)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The source story id"
    },
    "limit": {
      "type": "number",
      "description": "Max related stories (default 4, max 12)"
    }
  },
  "required": [
    "id"
  ]
}

list_categories

The BedrockNews category taxonomy: ids (valid values for list_stories' category filter), display names, and which editorial framework each category runs (grin | culture | auto).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_site_info

BedrockNews metadata: what the site is, how the GRIN/CLAIMS/NOVEL frameworks work, terms of use + attribution, and every machine-readable surface. Also returns the full capability map (every tool, prompt, and resource) — call this first.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

BedrockNews

Model Context Protocol (MCP) Server: com.bedrocknews/news

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_stories

get_article

get_extraction_graph

get_related

list_categories

get_site_info

Install

Remote endpoint