How kierandotai/jev-scout works
jev-scout is an MCP stdio service that lets agents search and fetch web pages, scores research steps with Jev, optionally gates results, and records decisions for a live dashboard and research reports. Its main flow is MCP tool calls through a shared pipeline: search backends return results for judging, while fetch requests pass a safety-checked fetcher before page judging. Cache, budget, and ledger are internal layers. The README documents the report and dashboard capabilities; source excerpts do not expose every registration or dashboard detail, so uncertain links are omitted or marked unverified.
Main entry points: pipeline.ts Tool pipeline · server-mcp.ts MCP tools · resolve.ts Backend resolver · ledger.ts Decision ledger
Components 19
Agent interface
- MCP tools
src/server-mcp.ts
Research workflow
- Tool pipeline
src/pipeline.ts - Backend resolver
src/backends/resolve.ts - SearXNG backend
src/backends/searxng.ts - Brave backend
src/backends/brave.ts - DuckDuckGo backend
src/backends/duckduckgo.ts - Safe page fetcher
src/fetcher.ts
Judgment controls
- Runtime config
src/config.ts - Jev judging
src/judge.ts - Judgment cache
src/cache.ts - Result gating
src/gate.ts - Call and spend budget
src/budget.ts
Observability
- Decision ledger
src/ledger.ts - Live dashboard
src/dashboard.ts - Drift analysis
src/drift.ts - Content hashing
src/hash.ts
Other components
- Research agent
- Web sources
- Jev service
Connections 23
- Research agent → MCP tools: calls tools
README.md - MCP tools → Tool pipeline: dispatches
src/server-mcp.ts - Tool pipeline → Runtime config: uses settings
src/pipeline.ts - Tool pipeline → Backend resolver: resolves search
src/pipeline.ts - Backend resolver → SearXNG backend: selects backend
src/backends/searxng.ts - Backend resolver → Brave backend: selects backend
src/backends/brave.ts - Backend resolver → DuckDuckGo backend: selects backend
src/backends/duckduckgo.ts - SearXNG backend → Web sources: searches
README.md - Brave backend → Web sources: searches
README.md - DuckDuckGo backend → Web sources: searches
README.md - Tool pipeline → Jev judging: scores results
src/pipeline.ts - Tool pipeline → Safe page fetcher: fetches pages
src/pipeline.ts - Safe page fetcher → Web sources: retrieves pages
README.md - Jev judging → Jev service: requests decisions
src/judge.ts - Tool pipeline → Judgment cache: reads and writes
src/pipeline.ts - Tool pipeline → Result gating: applies thresholds
src/pipeline.ts - Tool pipeline → Call and spend budget: reserves calls
src/pipeline.ts - Tool pipeline → Decision ledger: appends decisions
src/pipeline.ts - MCP tools → Live dashboard: starts dashboard
src/server-mcp.ts - Live dashboard → Decision ledger: streams events
src/dashboard.ts - MCP tools → Decision ledger: reports activity
src/server-mcp.ts - Drift analysis → Jev judging: uses judgments
src/drift.ts - Decision ledger → Content hashing: hashes content
src/ledger.ts