← Watchboard

Watchboard for AI Agents

Watchboard exposes its full intelligence database to AI agents through three integration paths: a Claude Skill, an MCP server, and a public JSON API. Query casualty figures, KPIs, breaking news, and daily digests — directly from your AI assistant.

Claude Skill

The Watchboard skill teaches Claude how to query trackers, interpret KPIs, and surface contested claims. Install it once and Claude will automatically use it whenever you ask about topics covered by Watchboard.

Claude Code
/skill install watchboard
Manual install — copy SKILL.md to your skills directory
mkdir -p ~/.claude/skills/watchboard
curl -sL https://watchboard.dev/skill/SKILL.md \
  -o ~/.claude/skills/watchboard/SKILL.md
Source
github.com/anthropics/skills/tree/main/skills/watchboard

What you can ask

"What's the latest on the Iran conflict?"
"Give me the casualty figures for Ukraine"
"What's breaking on Watchboard right now?"
"Summarize the Gaza tracker"
"Show me KPIs for the Sinaloa fragmentation tracker"
"Search for ceasefire events across all trackers"

MCP Server

The Model Context Protocol server exposes Watchboard data as native tools in Claude Desktop, Cursor, and any MCP-compatible client. Includes watchboard_get_tracker_claims for contested claims — exclusive to MCP.

Setup
git clone https://github.com/ArtemioPadilla/watchboard.git
cd watchboard/mcp && npm install
Claude Code
claude mcp add watchboard -- npx tsx /path/to/watchboard/mcp/server.ts
Claude Desktop — add to claude_desktop_config.json
{
  "mcpServers": {
    "watchboard": {
      "command": "npx",
      "args": ["tsx", "/path/to/watchboard/mcp/server.ts"]
    }
  }
}
watchboard_list_trackers List all active trackers
watchboard_get_tracker_summary Headline + KPIs + digest
watchboard_get_tracker_events Recent events with sources
watchboard_get_breaking_news All current breaking items
watchboard_search_events Keyword search across trackers
watchboard_get_tracker_kpis Structured KPI data
watchboard_get_tracker_claims Contested claims — sideA vs sideB

Full MCP documentation →

JSON API

Direct access with no authentication, no rate limits, and full CORS support. Static files served from CDN — safe to call from any environment.

EndpointReturns
/api/v1/trackers.jsonAll trackers with metadata
/api/v1/trackers/{slug}.jsonFull tracker: KPIs, events, digest
/api/v1/breaking.jsonActive breaking news
/api/v1/kpis/{slug}.jsonKPIs only (lightweight)
/api/v1/events/{slug}.jsonLast 30 events
/api/v1/search-index.jsonAll event titles for search

Full API documentation →

Python CLI

Zero-dependency script for querying Watchboard from any Python 3.8+ environment.

python3 scripts/watchboard.py summary iran-conflict
python3 scripts/watchboard.py breaking
python3 scripts/watchboard.py kpis ukraine-war
python3 scripts/watchboard.py events gaza-war --limit 10
python3 scripts/watchboard.py search "ceasefire"
python3 scripts/watchboard.py list --domain conflict

View script on GitHub →

Data Quality

Every data point carries a source tier classification. Events are marked confirmed only when backed by a Tier-1 source or two independent Tier-2 sources. KPIs include contested flags with opposing perspectives.

Tier 1 Official — Pentagon, UN, IAEA, government statements
Tier 2 Major outlets — Reuters, AP, BBC, Al Jazeera, AFP
Tier 3 Institutional — think tanks, NGOs, academic sources
Tier 4 Unverified — social media, anonymous, Telegram