Skip to main content
Glama
Sign In
InstacartCartSubstitutionAffinityResolver

InstacartCartSubstitutionAffinityResolver

by alphaparkinc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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.

🌐 Official GenPark AI Ecosystem Links

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • genpark-cross-platform-commerce-inventory-arbitrage-skill

    genpark-cross-platformofficial

    alphaparkinc
    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
  • genpark-commerce-dynamic-bundling-recommender-skill

    genpark-commerce-dynamicofficial

    alphaparkinc
    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

  • genpark-commerce-dynamic

    Alpha-Park
    A
    license
    Not graded
    quality
    B
    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.
    7
    MIT