Skip to main content
Glama
InstacartCartSubstitutionAffinityResolver

InstacartCartSubstitutionAffinityResolver

genpark-instacart-cart-substitution-affinity-resolver-skill

Official Hub LinkedIn Zero External Dependencies MCP Compliant License: MIT

Official Website: https://www.genpark.ai
LinkedIn: https://www.linkedin.com/company/92955550 (https://www.llinkedin.com/company/92955550)

Instacart AI & Walmart Grocery-inspired Cart Substitution & Preference Affinity Resolver. Solves real-time out-of-stock product disruptions by enforcing dietary constraints (vegan, gluten-free, organic), unit price delta ceilings (+15%), and brand affinity scoring.



Related MCP server: genpark-commerce-dynamic-bundling-recommender-skill

🌟 Key Features

  • 100% Zero External Dependencies: Runs entirely on the Python 3.9+ standard library.

  • Model Context Protocol (MCP) Standard: Native support for JSON-RPC 2.0 initialize, tools/list, and tools/call.

  • Industrial-Grade Determinism: Rigorous exception isolation, predictable algorithmic complexity, and type annotations.

  • Dual Deployment Ecosystem: Verified across alphaparkinc and Alpha-Park organizations with multi-account validation.


πŸš€ Quick Start

1. Direct Python SDK Usage

from client import InstacartCartSubstitutionAffinityResolver

def main():
    resolver = InstacartCartSubstitutionAffinityResolver()
    out_of_stock = {
        "title": "Avocado Oil Mayo 12oz",
        "category": "Condiments",
        "brand": "Primal Kitchen",
        "price_usd": 8.99,
        "dietary_tags": ["keto", "gluten_free"]
    }
    candidates = [
        {"title": "Chosen Foods Avocado Oil Mayo 12oz", "category": "Condiments", "brand": "Chosen Foods", "price_usd": 9.29, "dietary_tags": ["keto", "gluten_free"]},
        {"title": "Standard Soybean Mayo 30oz", "category": "Condiments", "brand": "Hellmanns", "price_usd": 4.99, "dietary_tags": []}
    ]
    res = resolver.resolve_out_of_stock_substitution(out_of_stock, candidates, {"max_price_delta_pct": 10.0})
    print("--- Instacart Real-Time Substitution Decision ---")
    print(f"Original (OOS): {res['original_item']}")
    print(f"Verdict: {res['action_verdict']}")
    if res['chosen_substitute']:
        print(f"Auto-Replaced With: {res['chosen_substitute']['title']} (${res['chosen_substitute']['price_usd']})")

if __name__ == "__main__":
    main()

2. Run as Model Context Protocol (MCP) Server

Start standard JSON-RPC 2.0 server over stdio:

python mcp_server.py

Execute embedded test harness:

python mcp_server.py --test

πŸ› οΈ MCP Tool Specification

Inspect skill.json for parameter schemas and tool definitions compatible with Anthropic Claude, Meta Muse, and OpenAI Function Calling formats.


πŸ“œ License & Community

Licensed under the MIT License. Copyright Β© 2026 GenPark AI. Follow us on LinkedIn: https://www.linkedin.com/company/92955550 | https://www.llinkedin.com/company/92955550

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables real-time multi-merchant price comparison, coupon stacking, delivery-speed trade-offs, stock volatility tracking, and optimal purchase routing for cross-platform commerce inventory arbitrage.
      7
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to analyze cart items and intent, compute product complementary affinity scores, respect merchant margin constraints, and synthesize personalized discount bundles for cross-sell recommendations.
      7
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables analysis of cart items and shopper intent, computation of complementary product affinity scores, enforcement of merchant margin constraints, and synthesis of personalized discount bundles and cross-sell recommendations via MCP.
      MIT