Test Arena MCP

A Node.js package that provides easy access to the Arena MCP (Model Context Protocol) Server with OAuth2 + PKCE authentication.

Features

• 🚀 Zero-config setup - Pre-configured with Arena's OAuth2 settings
• 🔐 OAuth2 + PKCE - Secure authentication flow built-in
• 🌍 Cross-platform - Supports Windows, macOS (Intel & ARM), and Linux
• 📦 Self-contained - No Python or additional dependencies required
• 🔄 Auto-caching - Downloads binaries once and caches them locally
• 🛠️ CLI & API - Use as a command line tool or programmatically in Node.js
• ✨ Ready to use - No environment variables or configuration needed

Quick Start

1. Install and Run (Zero Configuration!)

The package comes pre-configured with all necessary OAuth2 settings. No environment variables needed!

npx test-arena-mcp

2. That's it!

The server will:

• ✅ Download the correct binary for your platform automatically
• ✅ Use pre-configured OAuth2 settings for Arena's test environment
• ✅ Handle authentication with PKCE flow
• ✅ Encrypt and cache tokens securely
• ✅ Open your browser for OAuth authentication when needed

Supported Platforms

| Platform | Architecture | Binary Name | |----------|-------------|-------------| | Windows | x64 | arena-mcp-server_windows.exe | | macOS | x64 (Intel) | arena-mcp-server_macos_x64 | | macOS | arm64 (M1/M2) | arena-mcp-server_macos_arm64 | | Linux | x64 | arena-mcp-server_linux_x64 | | Linux | arm64 | arena-mcp-server_linux_arm64 |

How It Works

1. Platform Detection: Automatically detects your OS and architecture
2. Binary Download: Downloads the appropriate binary from the configured URL
3. Caching: Stores the binary locally to avoid repeated downloads
4. Validation: Verifies binary integrity and permissions
5. Execution: Spawns the binary with the provided arguments

MCP Server Features

The underlying MCP server provides:

• OAuth2 Authorization Code Flow with PKCE for secure authentication
• Encrypted token caching for persistent sessions
• Comprehensive Tool Set with 40+ specialized tools:

📋 Core & Navigation Tools

• arena_greet - Welcome message with quick action menu
• arena_get_company_info - Company information
• arena_get_service_info - Service offerings
• arena_get_distributor_info - Distributor brands
• arena_get_thanks / arena_get_goodbye - Polite responses
• arena_logout - Session termination

🛍️ Product & Inventory Tools

• arena_get_product_info - Detailed product information
• arena_get_stock_info - Stock availability check
• arena_get_stock_info_with_code - Formatted stock response
• arena_search_products - Basic product search
• arena_search_products_advanced - Advanced product search
• arena_get_catalog_info - Product catalog/specifications

📦 Order & Shipping Tools

• arena_get_order_info - Order status inquiry
• arena_get_order_return_details - Order return status
• arena_get_waybill_info - Waybill and e-invoice information

🔧 Technical Support Tools

• arena_get_technical_service_info - Technical service status
• arena_get_product_warranty - Product warranty information
• arena_check_product_serial - IMEI/Serial number verification

💰 Financial Tools

• arena_get_dealer_balance - Dealer account balance
• arena_get_dealer_credit_limit - Credit limit information
• arena_request_credit_limit_increase - Credit limit increase request

📞 Contact & Information Tools

• arena_get_contact_info - Location-based contact information
• arena_get_customer_service_contact - Customer service details
• arena_get_whatsapp_contact - WhatsApp contact link
• arena_get_mecidiyekoy_delivery_point - Delivery point information

📋 Administrative Tools

• arena_get_doa_info - Defective product exchange information
• arena_get_defective_product_info - Defective product guidance
• arena_get_transport_info - Shipping address information
• arena_get_working_hours - Business hours and shipping times
• arena_get_ticari_sicil_info - Commercial registry information

🔗 Portal & System Access Tools

• arena_get_portal_info - Pencere portal access
• arena_get_tencere_system - Tencere system access
• arena_get_password_change_info - Password change portal
• arena_get_personnel_info - Personnel management portal
• arena_get_rpa_info - RPA/UiPath information
• arena_get_credit_card_info - Credit card payment rates
• arena_get_pricing_info - Pricing information guidance

💬 Communication Tools

• arena_process_complaint - Submit complaints/suggestions
• arena_analyze_intent - Message intent analysis
• arena_process_slot_filling - Conversational slot filling

🔄 Smart Middleware Tools

• arena_account_middleware - Routes balance vs credit limit requests
• arena_info_middleware - Routes company info requests
• arena_complaint_middleware - Routes complaint processes
• arena_technical_service_middleware - Routes technical service requests
• arena_order_process_middleware - Routes order-related processes
• arena_product_stock_middleware - Routes product and stock queries

🎯 Additional Features

• Multi-language support (Turkish primary)
• Context-aware responses with slot filling
• Error handling with helpful guidance
• Session management for complex workflows
• Real-time data integration with Arena systems

Support

• 📖 Documentation