Skip to main content
Glama
ehurrn

newsroom-mcp

by ehurrn
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

newsroom-mcp

Type-safe MCP server for investigative journalism. The sole, validating writer to an investigation's master-file.json — enforcing the evidentiary standards that prompt-based editing cannot guarantee.

Companion to newsroom-extension, the Claude Code / Gemini plugin that defines the investigation framework. The plugin teaches an LLM how to investigate; this server ensures the resulting evidence record is structurally correct.

Why

An LLM editing master-file.json directly will eventually:

  • Mark a claim publishable without A1/A2 evidence

  • Assign a non-existent DOC- id to a claim

  • Overwrite a collection_log entry instead of appending

  • Skip the Admiralty grade on a new evidence item

Any of these corrupts the chain of custody that protects the outlet in a libel proceeding. This server makes them impossible.

Related MCP server: agent-gate

Enforced invariants

Rule

Enforcement

Admiralty grade required at intake

add_evidence rejects missing reliability/credibility or custody block

Publishable gate

publishable: true blocked unless corroborated (two independent sources) OR single-source with ≥1 A1/A2 item

Defamation gate

defamation_risk: "high" claim cannot be published without comment_requested: true

Referential integrity

Every entity_id and evidence_id reference must exist before write commits

Append-only log

collection_log entries are never edited or deleted; server owns the monotonic seq

Atomic writes

Serialize → temp file → rename() — a crash mid-write never leaves a partial file

Concurrent safety

In-process write queue serializes simultaneous tool calls

Installation

Requires Node 18+. No global install needed — use npx.

npx @ehurrn/newsroom-mcp

Setup

Each investigation is a directory with its own master-file.json. Point the server at it via NEWSROOM_WORKSPACE.

mkdir -p ~/investigations/city-hall-contracts
cd ~/investigations/city-hall-contracts
git init

# Install the evidence gate pre-commit hook
NEWSROOM_WORKSPACE=. npx @ehurrn/newsroom-mcp init-hook

Connecting to your AI client

Claude Code

Add to ~/.claude/settings.json (global) or .claude/settings.json (project):

{
  "mcpServers": {
    "newsroom-mcp": {
      "command": "npx",
      "args": ["@ehurrn/newsroom-mcp"],
      "env": {
        "NEWSROOM_WORKSPACE": "/absolute/path/to/investigation"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "newsroom-mcp": {
      "command": "npx",
      "args": ["@ehurrn/newsroom-mcp"],
      "env": {
        "NEWSROOM_WORKSPACE": "/absolute/path/to/investigation"
      }
    }
  }
}

Antigravity / agy

{
  "mcpServers": {
    "newsroom-mcp": {
      "command": "npx",
      "args": ["@ehurrn/newsroom-mcp"],
      "env": {
        "NEWSROOM_WORKSPACE": "/absolute/path/to/investigation"
      }
    }
  }
}

Switch investigations by changing NEWSROOM_WORKSPACE and relaunching the server.

Tools

init_master_file

Initialize a new investigation. Fails if master-file.json already exists. Seeds collection_log entry #1.

{
  "id": "INV-2026-001",
  "title": "City Hall Contracts",
  "central_question": "Did Acme Corp receive preferential treatment?",
  "opened": "2026-06-21",
  "evidence_dir": "evidence/"
}

read_master_file

Return the full current state. No arguments.

upsert_entity

Create or update an entity. Omit id to create (server assigns the next ENT-NNN).

{
  "name": "Acme Corp",
  "type": "company",
  "roles": ["subject"],
  "jurisdictions": ["Delaware", "New York"],
  "identifiers": { "ein": "12-3456789" }
}

add_evidence

Add an evidence item. Admiralty grading and a full custody block are required. Returns the assigned DOC-NNN.

{
  "title": "Acme Corp 10-K (FY2025)",
  "source_type": "regulatory-filing",
  "reliability": "A",
  "credibility": "1",
  "custody": {
    "obtained_from": "https://sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=...",
    "obtained_date": "2026-06-21",
    "method": "public-registry",
    "hash": "sha256:abc123...",
    "local_path": "evidence/acme-10k-fy2025.pdf",
    "preservation_status": "preserved"
  },
  "summary": "Annual report disclosing related-party transactions with City vendor."
}

Admiralty scale:

Reliability

Meaning

A

Completely reliable (certified official record)

B

Usually reliable

C

Fairly reliable

D

Not usually reliable

E

Unreliable

F

Cannot be judged

Credibility

Meaning

1

Confirmed by independent sources

2

Probably true

3

Possibly true

4

Doubtful

5

Improbable

6

Cannot be judged

update_claim_status

Create or update a claim. The publishable gate is enforced at write time — the server computes whether the linked evidence actually supports the flag, rather than trusting the caller.

{
  "text": "Acme Corp received Contract C-2025-44 ($4.2M) without competitive bid, per City procurement records (DOC-001).",
  "entity_ids": ["ENT-001"],
  "evidence_ids": ["DOC-001"],
  "status": "single-source",
  "publishable": true,
  "defamation_risk": "medium"
}

append_collection_log

Manually append an audit entry. The log is append-only — entries cannot be edited or deleted.

{
  "actor": "reporter-jeh",
  "action": "comment-requested",
  "refs": ["ENT-001"],
  "notes": "Emailed Acme Corp comms director at press@acmecorp.com at 14:32 EST."
}

Pre-commit hook

The hook scans working/ and drafts/ in the investigation workspace for cited CLM-NNN IDs and blocks commits where a cited publishable claim lacks qualifying evidence.

# Install into the current investigation workspace
npx @ehurrn/newsroom-mcp init-hook

# Run manually at any time
npx @ehurrn/newsroom-mcp validate

Example gate failure:

✗ Evidence gate failed — commit blocked:

  CLM-003: publishable claim has no A1/A2 evidence and status is not 'corroborated'

Fix: update master-file.json via newsroom-mcp tools, or set publishable:false
until evidence meets the A1/A2 or corroborated standard.

Schema

master-file.json conforms to the schema defined in newsroom-extension. The vendored copy lives in schema/master-file.schema.json. To pull the latest:

node scripts/sync-schema.mjs /path/to/newsroom-extension
npm run codegen

Development

npm install          # installs deps and runs codegen
npm run typecheck    # tsc --noEmit
npm test             # vitest run
npm run build        # tsup → dist/

License

Unlicense

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • domin8

    1withall
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    A deterministic MCP server that enforces auditable workflows by requiring AI agents to provide structured justifications and obtain human approval for file operations. It provides a secure, tamper-evident pipeline for tracking agent intent and codebase changes through cryptographic signatures and SQLite indexing.
    AGPL 3.0

  • agent-gate

    Jott2121
    A
    license
    B
    quality
    B
    maintenance
    An MCP server that enforces fail-closed deterministic checks, independent refute-first review, and tamper-evident hash-chained receipts for AI agent outputs before claiming completion.
    4
    3
    MIT

  • SIFT Kernel

    Sathvik-1007
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that enforces forensic methodology and prevents hallucinations by requiring evidence links and deterministic verification, exposing 129 forensic operations across 14 categories with auto-correlation and reasoning engine.
    2
    MIT