feat: add MCP tools for Bloomreach Recommendations feature

[sigvardt]

Description

The bloomreachRecommendations.ts file exists in the core package sources but looking at the MCP server, there are no recommendation-related MCP tools registered. The Bloomreach Recommendations feature is one of the key platform capabilities (product recommendations, personalization models).

Expected Tools

Based on the sitemap (docs/SITEMAP.md), the Campaigns > Recommendations section should have:

• bloomreach.recommendations.list — List recommendation models
• bloomreach.recommendations.view — View model configuration and performance
• bloomreach.recommendations.prepare_create — Create a new recommendation model
• bloomreach.recommendations.prepare_configure — Configure model parameters
• bloomreach.recommendations.prepare_start / prepare_stop — Start/stop a model

Impact

Recommendations are listed in the sitemap as a key feature but have no MCP tools. This is a gap between the documented platform capabilities and the tool coverage.

[sigvardt]

🤖 Starting Work

I'm beginning work on this issue.

Branch: ai/issue-182-feat-add-mcp-tools-for-bloomreach-recommendations-
Status: Analyzing requirements and exploring codebase

---

I'll post progress updates as I work. If I need clarification, I'll ask here.

[sigvardt]

✅ Implementation Complete

PR: #194

What was done

Registered 5 new MCP tools for the Bloomreach Recommendations feature:

Tool	Method	Type
bloomreach.recommendations.list	listRecommendationModels	Read
bloomreach.recommendations.view_performance	viewModelPerformance	Read
bloomreach.recommendations.prepare_create	prepareCreateRecommendationModel	Write (2PC)
bloomreach.recommendations.prepare_configure	prepareConfigureRecommendationModel	Write (2PC)
bloomreach.recommendations.prepare_delete	prepareDeleteRecommendationModel	Write (2PC)

Files changed (3)

• packages/mcp/src/index.ts — 5 tool name constants + array entries
• packages/mcp/src/bin/bloomreach-mcp.ts — 5 tool route definitions with JSON Schema
• packages/mcp/src/__tests__/toolConstants.test.ts — Updated counts (262→267 tools, 34→35 domains)

Quality gates

• ✅ Typecheck — clean
• ✅ Lint — clean
• ✅ Tests — 4916 passed
• ✅ Build — success

Notes

• The core service already existed with all methods and executors — only MCP wiring was needed
• The issue mentioned prepare_start/prepare_stop but the core service implements prepare_delete instead; tools match the actual service API
• Auto-merge enabled on the PR

---

Completed: Mon Mar 16 2026