mcp-memory-gateway

Instructions

Implementation Reference

• adapters/mcp/server-stdio.js:257-280 (handler)

  The function that implements the logic for 'commerce_recall', aggregating quality scores based on commerce feedback.

  function buildCommerceRecallResponse(args = {}) {
    const requestedCategories = Array.isArray(args.categories) && args.categories.length > 0
      ? args.categories
      : COMMERCE_CATEGORIES;
    const modelPath = path.join(SAFE_DATA_DIR, 'feedback_model.json');
    const reliability = getReliability(loadModel(modelPath));
    const lines = ['## Commerce Quality Scores', ''];
  
    for (const category of requestedCategories) {
      const stats = reliability[category];
      if (!stats) continue;
      const successRate = typeof stats.success_rate === 'number'
        ? `${(stats.success_rate * 100).toFixed(1)}%`
        : 'n/a';
      lines.push(`- ${category}: ${successRate} success rate over ${stats.total || 0} samples`);
    }
  
    if (lines.length === 2) {
      lines.push('- No commerce quality scores recorded yet.');
    }
  
    lines.push('');
    lines.push(`Query: ${args.query || ''}`);
    return toTextResult(lines.join('\n'));

• scripts/tool-registry.js:425-437 (schema)

  The tool registration and schema definition for 'commerce_recall'.

  readOnlyTool({
    name: 'commerce_recall',
    description: 'Recall past feedback filtered by commerce categories (product_recommendation, brand_compliance, sizing, pricing, regulatory). Returns quality scores alongside memories for agentic commerce agents.',
    inputSchema: {
      type: 'object',
      required: ['query'],
      properties: {
        query: { type: 'string', description: 'Product or brand context to find relevant past feedback' },
        categories: { type: 'array', items: { type: 'string' }, description: 'Commerce categories to filter (default: all commerce categories)' },
        limit: { type: 'number', description: 'Max memories to return (default 5)' },
      },
    },
  }),

• adapters/mcp/server-stdio.js:426-427 (handler)

  The switch-case handler that calls the implementation function when the 'commerce_recall' tool is invoked.

  case 'commerce_recall':
    return buildCommerceRecallResponse(args);