food402 1.0.0

package/README.md

@@ -0,0 +1,124 @@
+# Food402 MCP Server
+
+An MCP (Model Context Protocol) server that enables AI assistants to order food from TGO Yemek. Simply chat with your AI assistant to browse restaurants, build your order, and complete checkout.
+
+## Installation
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "food402": {
+      "command": "npx",
+      "args": ["-y", "food402"],
+      "env": {
+        "TGO_EMAIL": "your-email@example.com",
+        "TGO_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+Replace `your-email@example.com` and `your-password` with your TGO Yemek credentials.
+
+## Prerequisites
+
+### Account Setup Required
+
+Before using this MCP server, you must have a TGO Yemek account with:
+
+1. **TGO Yemek account** - Create one at tgoyemek.com if you don't have one
+2. **Payment card saved to your account** - The checkout process requires a saved card; you cannot enter card details during ordering
+3. **At least one delivery address saved** (recommended) - You can add addresses through the MCP, but having one pre-configured makes ordering faster
+
+## Quick Start: Ordering Flow
+
+Here's the typical workflow when ordering food through the AI assistant:
+
+### 1. Select Delivery Address
+```
+"Show me my saved addresses"
+"Select my home address for delivery"
+```
+
+### 2. Find Restaurants
+```
+"What restaurants are near me?"
+"Search for pizza restaurants"
+"Find places that serve lahmacun"
+```
+
+### 3. Browse Menu & Add Items
+```
+"Show me the menu for [restaurant name]"
+"Add 2 lahmacun to my cart"
+"What customization options are available for this item?"
+```
+
+### 4. Review & Checkout
+```
+"Show me my basket"
+"Remove the drink from my order"
+"I'm ready to checkout"
+```
+
+### 5. Place Order
+```
+"Place my order using my saved card"
+```
+*Note: A browser window will open for 3D Secure verification. Complete the verification to finalize your order.*
+
+### 6. Track Order
+```
+"What's the status of my order?"
+"Show me my recent orders"
+```
+
+## Available Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `get_addresses` | Get user's saved delivery addresses | None |
+| `select_address` | Select delivery address (must call before ordering) | `addressId` |
+| `get_restaurants` | Search restaurants near a location | `latitude`, `longitude`, `page?` |
+| `search_restaurants` | Search restaurants and products by keyword | `searchQuery`, `latitude`, `longitude`, `page?` |
+| `get_restaurant_menu` | Get restaurant's full menu | `restaurantId`, `latitude`, `longitude` |
+| `get_product_details` | Get product customization options | `restaurantId`, `productId`, `latitude`, `longitude` |
+| `get_product_recommendations` | Get "goes well with" suggestions | `restaurantId`, `productIds[]` |
+| `add_to_basket` | Add items to cart | `storeId`, `items[]`, `latitude`, `longitude`, etc. |
+| `get_basket` | Get current cart contents | None |
+| `remove_from_basket` | Remove item from cart | `itemId` |
+| `clear_basket` | Clear entire cart | None |
+| `get_cities` | Get list of all cities for address selection | None |
+| `get_districts` | Get districts for a city | `cityId` |
+| `get_neighborhoods` | Get neighborhoods for a district | `districtId` |
+| `add_address` | Add a new delivery address | `name`, `surname`, `phone`, `addressName`, `addressLine`, `cityId`, `districtId`, `neighborhoodId`, `latitude`, `longitude`, etc. |
+| `get_saved_cards` | Get user's saved payment cards (masked) | None |
+| `checkout_ready` | Get basket ready for checkout with payment context | None |
+| `set_order_note` | Set order note and delivery preferences | `note?`, `noServiceWare?`, `contactlessDelivery?`, `dontRingBell?` |
+| `place_order` | Place order with 3D Secure (opens browser for verification) | `cardId` |
+| `get_orders` | Get user's order history with status | `page?` |
+| `get_order_detail` | Get detailed order info including delivery status | `orderId` |
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/getclave/food402.git
+cd food402
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm start
+
+# Build TypeScript
+npm run build
+```
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,417 @@
+export interface Address {
+    id: number;
+    name: string;
+    surname: string;
+    phone: string;
+    countryPhoneCode: string;
+    addressLine: string;
+    addressName: string;
+    postalCode: string;
+    cityId: number;
+    cityName: string;
+    districtId: number;
+    districtName: string;
+    neighborhoodId: number;
+    neighborhoodName: string;
+    latitude: string;
+    longitude: string;
+    addressDescription: string;
+    apartmentNumber: string;
+    floor: string;
+    doorNumber: string;
+    addressType: string;
+    elevatorAvailable: boolean;
+}
+export interface AddressesResponse {
+    infoMessage: string | null;
+    id: string;
+    addresses: Address[];
+}
+export interface Restaurant {
+    id: number;
+    name: string;
+    kitchen: string;
+    rating: number;
+    ratingText: string;
+    minBasketPrice: number;
+    averageDeliveryInterval: string;
+    distance: number;
+    neighborhoodName: string;
+    isClosed: boolean;
+    campaignText?: string;
+}
+export interface RestaurantsResponse {
+    restaurants: Restaurant[];
+    totalCount: number;
+    currentPage: number;
+    pageSize: number;
+    hasNextPage: boolean;
+}
+export declare function getAddresses(): Promise<AddressesResponse>;
+export interface MenuItem {
+    id: number;
+    name: string;
+    description: string;
+    price: number;
+    likePercentage?: string;
+}
+export interface MenuCategory {
+    name: string;
+    slug: string;
+    items: MenuItem[];
+}
+export interface RestaurantInfo {
+    id: number;
+    name: string;
+    status: string;
+    rating: number;
+    ratingText: string;
+    workingHours: string;
+    deliveryTime: string;
+    minOrderPrice: number;
+}
+export interface RestaurantMenuResponse {
+    info: RestaurantInfo;
+    categories: MenuCategory[];
+    totalItems: number;
+}
+export declare function getRestaurants(latitude: string, longitude: string, page?: number): Promise<RestaurantsResponse>;
+export declare function getRestaurantMenu(restaurantId: number, latitude: string, longitude: string): Promise<RestaurantMenuResponse>;
+export interface RecommendedItem {
+    id: number;
+    name: string;
+    description: string | null;
+    price: number;
+    imageUrl: string;
+}
+export interface RecommendationCollection {
+    name: string;
+    items: RecommendedItem[];
+}
+export interface ProductRecommendationsResponse {
+    collections: RecommendationCollection[];
+    totalItems: number;
+}
+export declare function getProductRecommendations(restaurantId: number, productIds: number[]): Promise<ProductRecommendationsResponse>;
+export interface ProductOption {
+    id: number;
+    name: string;
+    price: number;
+    selected: boolean;
+    isPopular?: boolean;
+}
+export interface ProductComponent {
+    type: "INGREDIENTS" | "MODIFIER_GROUP";
+    title: string;
+    description?: string;
+    modifierGroupId?: number;
+    options: ProductOption[];
+    isSingleChoice: boolean;
+    minSelections: number;
+    maxSelections: number;
+}
+export interface ProductDetailsResponse {
+    restaurantId: number;
+    restaurantName: string;
+    productId: number;
+    productName: string;
+    description: string;
+    imageUrl: string;
+    price: number;
+    maxQuantity: number;
+    components: ProductComponent[];
+}
+export declare function getProductDetails(restaurantId: number, productId: number, latitude: string, longitude: string): Promise<ProductDetailsResponse>;
+export interface IngredientExclusion {
+    id: number;
+}
+export interface ModifierProduct {
+    productId: number;
+    modifierGroupId: number;
+    modifierProducts: ModifierProduct[];
+    ingredientOptions: {
+        excludes: IngredientExclusion[];
+        includes: [];
+    };
+}
+export interface BasketItem {
+    productId: number;
+    quantity: number;
+    modifierProducts: ModifierProduct[];
+    ingredientOptions: {
+        excludes: IngredientExclusion[];
+        includes: [];
+    };
+}
+export interface AddToBasketRequest {
+    storeId: number;
+    items: BasketItem[];
+    isFlashSale: boolean;
+    storePickup: boolean;
+    latitude: number;
+    longitude: number;
+}
+export interface CartProduct {
+    productId: number;
+    itemId: string;
+    name: string;
+    quantity: number;
+    salePrice: number;
+    description: string;
+}
+export interface CartStore {
+    id: number;
+    name: string;
+    imageUrl: string;
+    rating: number;
+    averageDeliveryInterval: string;
+    minAmount: number;
+}
+export interface CartSummaryLine {
+    title: string;
+    amount: number;
+    isPromotion?: boolean;
+}
+export interface AddToBasketResponse {
+    store: CartStore;
+    products: CartProduct[];
+    summary: CartSummaryLine[];
+    totalProductCount: number;
+    totalProductPrice: number;
+    totalProductPriceDiscounted: number;
+    totalPrice: number;
+    deliveryPrice: number;
+}
+export interface SetShippingAddressRequest {
+    shippingAddressId: number;
+    invoiceAddressId: number;
+}
+export declare function setShippingAddress(request: SetShippingAddressRequest): Promise<void>;
+export declare function addToBasket(request: AddToBasketRequest): Promise<AddToBasketResponse>;
+export interface CartProductDetails extends CartProduct {
+    marketPrice: number;
+    modifierProducts: Array<{
+        productId: number;
+        modifierGroupId: number;
+        name: string;
+        price: number;
+    }>;
+    ingredientExcludes: Array<{
+        id: number;
+        name: string;
+    }>;
+}
+export interface CartStoreGroup {
+    store: CartStore;
+    products: CartProductDetails[];
+}
+export interface GetBasketResponse {
+    storeGroups: CartStoreGroup[];
+    summary: CartSummaryLine[];
+    totalProductCount: number;
+    totalProductPrice: number;
+    totalProductPriceDiscounted: number;
+    totalPrice: number;
+    deliveryPrice: number;
+    isEmpty: boolean;
+}
+export declare function getBasket(): Promise<GetBasketResponse>;
+export declare function removeFromBasket(itemId: string): Promise<GetBasketResponse>;
+export declare function clearBasket(): Promise<void>;
+export interface SearchProduct {
+    id: number;
+    name: string;
+    description?: string;
+    price: number;
+    imageUrl?: string;
+}
+export interface SearchRestaurant extends Restaurant {
+    products: SearchProduct[];
+    warning?: string;
+}
+export interface SearchRestaurantsResponse {
+    restaurants: SearchRestaurant[];
+    totalCount: number;
+    currentPage: number;
+    pageSize: number;
+    hasNextPage: boolean;
+    searchQuery: string;
+}
+export interface City {
+    id: number;
+    code: string;
+    name: string;
+}
+export interface District {
+    id: number;
+    name: string;
+}
+export interface Neighborhood {
+    id: number;
+    name: string;
+}
+export interface CitiesResponse {
+    cities: City[];
+    count: number;
+}
+export interface DistrictsResponse {
+    districts: District[];
+    count: number;
+    cityId: number;
+}
+export interface NeighborhoodsResponse {
+    neighborhoods: Neighborhood[];
+    count: number;
+    districtId: number;
+}
+export declare function getCities(): Promise<CitiesResponse>;
+export declare function getDistricts(cityId: number): Promise<DistrictsResponse>;
+export declare function getNeighborhoods(districtId: number): Promise<NeighborhoodsResponse>;
+export interface AddAddressRequest {
+    name: string;
+    surname: string;
+    phone: string;
+    apartmentNumber?: string;
+    floor?: string;
+    doorNumber?: string;
+    addressName: string;
+    addressDescription?: string;
+    addressLine: string;
+    cityId: number;
+    districtId: number;
+    neighborhoodId: number;
+    latitude: string;
+    longitude: string;
+    countryCode?: string;
+    elevatorAvailable?: boolean;
+}
+export interface AddAddressResponse {
+    success: boolean;
+    address?: Address;
+    requiresOtp?: boolean;
+    message: string;
+}
+export declare function addAddress(request: AddAddressRequest): Promise<AddAddressResponse>;
+export interface SavedCard {
+    cardId: number;
+    name: string;
+    maskedCardNumber: string;
+    cardTypeName: string;
+    bankName: string;
+    isDebitCard: boolean;
+    cvvRequired: boolean;
+    cardNetwork: string;
+}
+export interface SavedCardsResponse {
+    cards: SavedCard[];
+    hasCards: boolean;
+    message?: string;
+}
+export interface CheckoutReadyResponse {
+    ready: boolean;
+    store: CartStore;
+    products: CartProductDetails[];
+    summary: CartSummaryLine[];
+    totalPrice: number;
+    deliveryPrice: number;
+    warnings: string[];
+}
+export interface PlaceOrderResponse {
+    success: boolean;
+    orderId?: string;
+    requires3DSecure?: boolean;
+    redirectUrl?: string;
+    htmlContent?: string;
+    message: string;
+}
+export interface CustomerNoteRequest {
+    customerNote: string;
+    noServiceWare: boolean;
+    contactlessDelivery: boolean;
+    dontRingBell: boolean;
+}
+export declare function updateCustomerNote(request: CustomerNoteRequest): Promise<void>;
+export declare function getSavedCards(): Promise<SavedCardsResponse>;
+export declare function getCheckoutReady(): Promise<CheckoutReadyResponse>;
+export declare function placeOrder(cardId: number): Promise<PlaceOrderResponse>;
+export interface OrderStatus {
+    status: string;
+    statusText: string;
+    statusColor: string;
+}
+export interface OrderStore {
+    id: number;
+    name: string;
+}
+export interface OrderPrice {
+    totalPrice: number;
+    totalPriceText: string;
+    refundedPrice: number;
+    cancelledPrice: number;
+    totalDeliveryPrice: number;
+    totalServicePrice: number;
+}
+export interface OrderProductSummary {
+    productId: number;
+    name: string;
+    imageUrl: string;
+}
+export interface Order {
+    id: string;
+    orderDate: string;
+    store: OrderStore;
+    status: OrderStatus;
+    price: OrderPrice;
+    productSummary: string;
+    products: OrderProductSummary[];
+    isReady: boolean;
+}
+export interface OrdersResponse {
+    orders: Order[];
+    pagination: {
+        currentPage: number;
+        pageSize: number;
+        totalCount: number;
+        hasNext: boolean;
+    };
+}
+export interface OrderDetailProduct {
+    name: string;
+    imageUrl: string;
+    salePrice: number;
+    salePriceText: string;
+    quantity: number;
+    description: string;
+}
+export interface OrderStatusStep {
+    status: string;
+    statusText: string;
+}
+export interface OrderShipmentItem {
+    status: OrderStatus;
+    statusSteps: OrderStatusStep[];
+    products: OrderDetailProduct[];
+}
+export interface OrderDetail {
+    orderId: string;
+    orderNumber: string;
+    orderDate: string;
+    customerNote: string;
+    store: OrderStore;
+    eta: string;
+    deliveredDate: string;
+    status: OrderStatus;
+    statusSteps: OrderStatusStep[];
+    products: OrderDetailProduct[];
+    price: OrderPrice;
+    paymentDescription: string;
+    deliveryAddress: {
+        name: string;
+        address: string;
+        districtCity: string;
+        phoneNumber: string;
+    };
+}
+export declare function getOrders(page?: number): Promise<OrdersResponse>;
+export declare function getOrderDetail(orderId: string): Promise<OrderDetail>;
+export declare function searchRestaurants(searchQuery: string, latitude: string, longitude: string, page?: number): Promise<SearchRestaurantsResponse>;