Local MCP server
Trend Finder provides a local stdio MCP server for querying the validated generated payload without opening the browser.
bun --silent run trend-finder:mcpRegister it with Claude Code from the repository root:
claude mcp add trend-finder -- bun --silent run trend-finder:mcpOther MCP clients can use the same bun --silent run trend-finder:mcp stdio
command.
| Tool | Purpose |
|---|---|
trend_finder_top_opportunities |
Return ranked opportunities and hidden gems with verdict and evidence context |
trend_finder_check_topic |
Fuzzy-match one topic and return its closest current result |
trend_finder_run_summary |
Return the current pick, movement, verdict mix, source health, calibration, and spend summary |
Every response includes data, analysis, and source provenance so the client can distinguish live generated output from fixture or fallback states.
Boundary
Section titled “Boundary”The server reads the validated current payload and reuses the static Brief projection. It does not start collection, call source adapters, inspect source rows, or read collector diagnostics and history caches.
Remote published-data fallback is not part of this server. Run the client from the repository checkout that owns the local generated payload.
Verify
Section titled “Verify”bun run testbun run typecheck:scripts