kate-tortubekova/mcp-server

Market MCP Server

Local Development

1. Clone the repository:

git clone ...
cd mcp-server

2. Configure environment variables:

cp .env.example .env

3. Build and run using Docker Compose:

make build
make up

Docker Commands

Here are some useful Docker commands for managing the MCP server:

• Start the server: make up
• Stop the server: make down
• Rebuild the container: make build
• Enter into mcp container: make mcp-console
• Show mcp logs: make mcp-logs

Cursor Integration

To use the MCP server with Cursor AI:

1. Create a .cursor directory in your project root if it doesn't exist:

mkdir -p .cursor

2. Create an MCP configuration file at .cursor/mcp.json:

{
   "mcpServers": {
      "mcp-http": {
         "name": "MCP Server (HTTP)",
         "url": "http://localhost/mcp/sse",
         "description": "MCP Server with HTTP"
      }
   }
}

Tools

The server exposes the following MCP tools:

• account_check_code - Check user account code during initialization.
• account_confirm - Confirm user account registration with code and profile data.
• account_init - Initialize user account authentication.
• account_login - Log in to the user account.
• account_logout - Log out of the user account.
• account_refresh_access_token - Refresh the user account access token.
• get_account - Get user account (profile).
• get_account_balance - Get user account balance.
• get_account_loyalty_program - Get user account loyalty program.
• get_active_poll_rounds_count - Get active poll rounds count.
• get_charity_event - Get single charity event.
• get_city - Get a city by id.
• get_concurrent_marketplaces - Get the list of concurrent marketplaces by city id.
• get_discount_product - Get single discount product.
• get_gift_card - Get a single gift card.
• get_issued_voucher - Get single issued voucher.
• get_loyalty_bonus_information - Get information about bonus loyalty program.
• get_loyalty_employee_information - Get information about employee loyalty program.
• get_loyalty_pension_information - Get information about pension loyalty program.
• get_partner_program - Get a single partner program.
• get_poll_round - Get single poll round.
• get_promotion - Get a single promotion.
• get_purchase - Get a single purchase.
• get_purchases_analytics - Get user purchases analytics.
• get_purchases_totals - Get user purchases totals.
• get_random_region - Get a random region.
• get_random_store - Get a random store.
• get_region - Get a region by id.
• get_store - Get a store by id.
• get_store_total_upsells - Get the list of total upsells for a store.
• get_unread_notification_count - Get unread notification count.
• get_unviewed_gift_cards_count - Get the count of unviewed gift cards.
• list_charity_events - Get list of the charity events paginated.
• list_cities - Get the list of cities paginated.
• list_discount_banners - Get list of the discount banners paginated.
• list_discount_products - Get a list of discounted products across all discount categories.
• list_discount_products_active_categories - Get list of the discount products active categories paginated.
• list_discounts - Get a list of discount categories.
• list_gift_cards - Get list of gift cards paginated.
• list_issued_vouchers - Get list of the issued vouchers paginated.
• list_notifications - Get list of notifications paginated.
• list_partner_programs - Get list of the partner programs paginated.
• list_poll_rounds - Get list of the poll rounds paginated.
• list_product_categories - Get list of product categories paginated.
• list_promotions - Get list of the promotions paginated.
• list_purchases - Get list of the purchases paginated.
• list_regions - Get the list of regions paginated.
• list_store_menus - Get list of the store menu products paginated.
• list_stores - Get the list of stores.
• update_account - Update user account.