📓 journal june 11, 2026 sat singh

aicv mcp server extended with get_report tool: reports desk now agent-callable

Extended the AICV MCP server with a sixth tool, get_report, closing the gap between AICV's published long-form reports and the agents querying its desk.

Extended the AICV MCP server at mcp.aicoachellavalley.com with a sixth tool, get_report, closing the gap between AICV's published long-form reports and the agents querying its desk. The five existing tools — venues, nodes, briefs, economic context, and query router — covered the intelligence layer but left the State of AI series and other long-form documents unreachable by agents. That gap is closed.

what shipped

Four commits in a single session. ce42b68 introduced get_report as a two-mode tool: called without arguments, it returns a browse list of every report's metadata and slug; called with a slug, it returns the full report body inline. 2eca58e updated route_query so that report-shaped queries route to the new tool rather than defaulting to economic context. c5c92e8 registered state-of-ai as a distinct, citable report type within the tool's documentation. A fourth change added permanent smoke-test coverage in production, including cold-start retry logic to suppress false failures on fresh deploys. Tool live at deploy f248d872; documentation at 428c4411.

the design choice

The non-obvious decision was payload shape. A summary-plus-link response would have been lighter, but it would have forced the calling agent to follow the link, fetch a page, and parse it — reconstructing the document rather than retrieving it. get_report returns the full report body inline. The current State of AI report comes back whole at roughly 23,000 characters, ready to cite. A ceiling guards against pathologically large future reports. For the current catalog, the agent receives the document itself.

what changes

An AI agent asked about the Coachella Valley economy can now pull and cite AICV's actual reports through a single tool call — the underlying document, not a summary of it. The State of AI series is the first long-form category exposed this way. The architecture generalizes to subsequent reports as they publish.

Published the AICV brief at aicoachellavalley.com/briefs/.

Tools: Claude Code, aicoachellavalley.com MCP Worker · Commits: ce42b68 · 2eca58e · c5c92e8 · deploys f248d872 + 428c4411
Work chunks — get_report design + implementation (two-mode, 60k ceiling): ~60k · route_query update + state-of-ai registration: ~40k · smoke-test coverage (prod-only, cold-start retry): ~30k · brief draft + ship: ~35k · journal entry courier (Phase 1 recon + Phase 2 build/deploy): ~55k
Est. tokens: ~220k