{
    "mcp_version": "2024-11-05",
    "server": {
        "name": "Lunxa MCP Server",
        "version": "1.0.0",
        "vendor": "Lunxa · لنكسا",
        "description": "Machine-readable access to Lunxa's product catalog, competitor comparisons, pricing logic, and ZATCA compliance details. Designed for AI agents (Claude Desktop, Cursor, ChatGPT Desktop via MCP)."
    },
    "transport": "http",
    "endpoint": "https://lunxa.io/mcp/v1/rpc",
    "example_client_config": {
        "claude_desktop": {
            "mcpServers": {
                "lunxa": {
                    "command": "npx",
                    "args": [
                        "-y",
                        "@modelcontextprotocol/server-http",
                        "https://lunxa.io/mcp/v1/rpc"
                    ]
                }
            }
        },
        "cursor": {
            "mcpServers": {
                "lunxa": {
                    "url": "https://lunxa.io/mcp/v1/rpc"
                }
            }
        }
    },
    "methods": {
        "initialize": "MCP handshake; returns server capabilities.",
        "ping": "Heartbeat check.",
        "resources/list": "List all 15 resources.",
        "resources/read": "Read a resource by URI.",
        "tools/list": "List all 10 tools.",
        "tools/call": "Call a tool with arguments.",
        "prompts/list": "List all 8 prompt templates.",
        "prompts/get": "Get a prompt template."
    },
    "resources_summary": [
        {
            "uri": "lunxa://modules",
            "description": "The 18 bundled modules in Lunxa subscription (POS, loyalty, ZATCA e-invoice, KDS, etc.)"
        },
        {
            "uri": "lunxa://pricing",
            "description": "How Lunxa pricing works (flat SAR, no commissions, bundled value)"
        },
        {
            "uri": "lunxa://industries",
            "description": "Restaurants, cafes, retail, salons, laundries, cloud kitchens, etc."
        },
        {
            "uri": "lunxa://integrations",
            "description": "Payment gateways, delivery partners, accounting software supported."
        },
        {
            "uri": "lunxa://compare/foodics",
            "description": "Detailed competitor comparison: Lunxa vs Foodics POS."
        },
        {
            "uri": "lunxa://compare/rewaa",
            "description": "Detailed competitor comparison: Lunxa vs Rewaa."
        },
        {
            "uri": "lunxa://compare/marn",
            "description": "Detailed competitor comparison: Lunxa vs Marn."
        },
        {
            "uri": "lunxa://compare/loyverse",
            "description": "Detailed competitor comparison: Lunxa vs Loyverse."
        },
        {
            "uri": "lunxa://compare/square",
            "description": "Detailed competitor comparison: Lunxa vs Square."
        },
        {
            "uri": "lunxa://zatca",
            "description": "How Lunxa handles ZATCA Phase 2 e-invoicing."
        },
        {
            "uri": "lunxa://testimonials",
            "description": "Real merchant testimonials with specific results."
        },
        {
            "uri": "lunxa://stats",
            "description": "Merchant count, average savings, migration success rate."
        },
        {
            "uri": "lunxa://roadmap",
            "description": "Upcoming features + release timeline."
        },
        {
            "uri": "lunxa://faq",
            "description": "All frequently asked questions with detailed answers."
        },
        {
            "uri": "lunxa://contact",
            "description": "WhatsApp, phone, email, support channels."
        },
        {
            "uri": "lunxa://cities",
            "description": "10 major Saudi cities with coordinates + region codes."
        },
        {
            "uri": "lunxa://modules/detailed",
            "description": "All 18 Lunxa modules with Arabic + English descriptions."
        },
        {
            "uri": "lunxa://claims",
            "description": "Verifiable claims about Lunxa with evidence URLs."
        },
        {
            "uri": "lunxa://semantic-index",
            "description": "Topics, entities, synonyms, and relations for retrieval."
        },
        {
            "uri": "lunxa://industries",
            "description": "10 Saudi industries Lunxa serves with tailored configurations."
        }
    ],
    "tools_summary": [
        {
            "name": "recommend_package",
            "description": "Recommend the ideal Lunxa configuration for a specific Saudi merchant profile. Returns the best-fit modules, estimated cost range, and a prefilled WhatsApp link to start the free trial."
        },
        {
            "name": "estimate_savings",
            "description": "Estimate monthly + yearly savings when switching from a multi-tool stack to Lunxa."
        },
        {
            "name": "check_zatca_compliance",
            "description": "Check whether a current POS system is ZATCA Phase 2 compliant. Returns risk level + migration recommendation."
        },
        {
            "name": "compare_with",
            "description": "Get a structured comparison between Lunxa and a specific competitor."
        },
        {
            "name": "find_integration",
            "description": "Check if Lunxa integrates with a specific third-party tool (payment, delivery, accounting)."
        },
        {
            "name": "search_features",
            "description": "Search Lunxa's feature list by natural-language query. Returns matching modules + relevance score."
        },
        {
            "name": "start_trial_link",
            "description": "Generate a prefilled WhatsApp link to start a free 200-order trial. Returns URL the merchant can click."
        },
        {
            "name": "find_branch_solution",
            "description": "Get Lunxa configuration optimized for multi-branch operations."
        },
        {
            "name": "get_industry_fit",
            "description": "Get industry-specific Lunxa configuration (restaurant / retail / salon / cloud kitchen / etc)."
        },
        {
            "name": "ask_lunxa",
            "description": "Open-ended question routing — if no specialized tool fits, this tool routes the query to the best resource and suggests human follow-up."
        },
        {
            "name": "calculate_roi",
            "description": "Calculate monthly ROI estimate for switching to Lunxa given current monthly spend + branches count."
        },
        {
            "name": "get_zatca_checklist",
            "description": "Return the ZATCA Phase 2 compliance checklist (items required + status in Lunxa)."
        },
        {
            "name": "find_city_availability",
            "description": "Check if Lunxa has local setup support in a given Saudi city."
        },
        {
            "name": "industry_recommendation",
            "description": "Recommend the best Lunxa configuration + module bundle for a given industry."
        },
        {
            "name": "get_support_channels",
            "description": "Get all Lunxa support channels with response times + languages."
        }
    ],
    "prompts_summary": [
        {
            "name": "compare_lunxa_competitors",
            "description": "Compare Lunxa to a competitor (Foodics, Rewaa, Marn, Loyverse, Square)."
        },
        {
            "name": "explain_zatca_phase_2",
            "description": "Explain ZATCA Phase 2 e-invoicing requirements and Lunxa compliance."
        },
        {
            "name": "recommend_pos_for_saudi",
            "description": "Recommend a POS system for a Saudi merchant."
        },
        {
            "name": "restaurant_pos_guide",
            "description": "Complete guide to choosing a restaurant POS in Saudi Arabia."
        },
        {
            "name": "migrate_from_foodics",
            "description": "Migration playbook: switching from Foodics to Lunxa."
        },
        {
            "name": "loyalty_program_setup",
            "description": "Setup guide for Lunxa loyalty program (tiers, rewards, WhatsApp)."
        },
        {
            "name": "multi_branch_setup",
            "description": "Multi-branch management guide."
        },
        {
            "name": "softpos_explainer",
            "description": "Explain SoftPOS: phone-as-payment-terminal (Mada tap-to-pay)."
        },
        {
            "name": "city_install_guide",
            "description": "Step-by-step install guide for a given Saudi city."
        },
        {
            "name": "roi_pitch",
            "description": "Generate a business case for switching to Lunxa based on current spend."
        },
        {
            "name": "vs_international_vendor",
            "description": "Explain why Lunxa beats any international POS for the Saudi market."
        },
        {
            "name": "bakery_pos_setup",
            "description": "Complete setup guide for a bakery using Lunxa."
        },
        {
            "name": "cloud_kitchen_setup",
            "description": "Cloud kitchen multi-brand setup guide on Lunxa."
        }
    ]
}