{"_id":"@chanaka_nakandala/mcp-server","name":"@chanaka_nakandala/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@chanaka_nakandala/mcp-server","version":"1.0.0","description":"MCP server that provides Grubtech API documentation search and code generation tools for Claude Code.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"grubtech-mcp-server":"dist/index.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"scripts":{"build":"node ../../node_modules/typescript/lib/tsc.js","dev":"node ../../node_modules/typescript/lib/tsc.js --watch","clean":"rm -rf dist","test":"echo \"Tests will be added in future iteration\""},"keywords":["grubtech","grubtech-api","grubtech-integration","mcp","mcp-server","model-context-protocol","claude","claude-code","claude-desktop","api-integration","code-generation","documentation-search","typescript","python","java","curl","webhook","restaurant-tech","pos-integration","food-delivery","menu-sync","order-management"],"author":{"name":"Grubtech","email":"support@grubtech.io"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.12.2","cheerio":"^1.1.2"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.9.3"},"engines":{"node":">=18.0.0","npm":">=10.0.0"},"_id":"@chanaka_nakandala/mcp-server@1.0.0","gitHead":"82d3895c15f393d7f24cc16cbe00035ab4d29f45","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-F1bwFYlfbsH6++/M4nAeWLe0nGrgJv9DQAtMJmvHmMad2hZaDl3vfVkxYVZGXmYfxYsT+8FNpBaxuGbj+im72w==","shasum":"2127bc7c7b3a04678c80b2dc7915d748f27a1cea","tarball":"https://registry.npmjs.org/@chanaka_nakandala/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":64,"unpackedSize":222485,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDQGos8j5+FdBKlITEvAnWaEJ+fQ54jUAbioFRXv/NBOAiEAnQLAXPnrpMAlkYyhWo9a4Jsin69DcWwlIG+wfdFry8s="}]},"_npmUser":{"name":"chanaka_nakandala","email":"chanaka@grubtech.com"},"directories":{},"maintainers":[{"name":"chanaka_nakandala","email":"chanaka@grubtech.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.0_1760112398028_0.4919608312185417"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-10T16:06:37.905Z","1.0.0":"2025-10-10T16:06:38.200Z","modified":"2025-10-10T16:06:38.439Z"},"maintainers":[{"name":"chanaka_nakandala","email":"chanaka@grubtech.com"}],"description":"MCP server that provides Grubtech API documentation search and code generation tools for Claude Code.","keywords":["grubtech","grubtech-api","grubtech-integration","mcp","mcp-server","model-context-protocol","claude","claude-code","claude-desktop","api-integration","code-generation","documentation-search","typescript","python","java","curl","webhook","restaurant-tech","pos-integration","food-delivery","menu-sync","order-management"],"author":{"name":"Grubtech","email":"support@grubtech.io"},"license":"MIT","readme":"# Grubtech Integration Assistant\n\n> **AI-powered integration helper for Claude Code**\n> Get instant answers, generate code, and build Grubtech integrations faster\n\n---\n\n## 📖 What is This?\n\nIf you're a **restaurant, POS system, delivery platform, or cloud kitchen** building an integration with Grubtech APIs, this tool helps you work faster by providing:\n\n- ✅ **Instant answers** to API questions (no more searching docs)\n- ✅ **Production-ready code** in TypeScript, Python, Java, or cURL\n- ✅ **AI guidance** from specialized Developer and Business Analyst agents\n- ✅ **Smart documentation search** using natural language\n\n**Example:** Instead of searching docs for 30 minutes, just ask:\n*\"How do I authenticate with Grubtech?\"* → Get working code instantly.\n\n---\n\n## 🍔 What is Grubtech?\n\n[**Grubtech**](https://www.grubtech.com) is a leading cloud-based restaurant technology platform that powers:\n- Cloud kitchens and virtual restaurants\n- Multi-channel online ordering (delivery apps, web, mobile)\n- Menu management across platforms\n- Order aggregation and kitchen operations\n\n**For Developers:** If you're integrating your restaurant POS, delivery platform, or ordering system with Grubtech, you'll need to work with their REST APIs.\n\n**Official Resources:**\n- 🌐 Website: https://www.grubtech.com\n- 📚 API Documentation: https://docs.grubtech.io\n- 📧 Support: support@grubtech.io\n\n---\n\n## 👥 Who Should Use This?\n\nThis tool is perfect for **external developers** who are:\n\n✅ **Restaurant/POS Developers** - Integrating your point-of-sale system with Grubtech\n✅ **Delivery Platform Engineers** - Building order sync between your platform and Grubtech\n✅ **Cloud Kitchen Tech Teams** - Connecting kitchen management systems\n✅ **Integration Consultants** - Building custom integrations for clients\n✅ **Technical Partners** - Developing apps in the Grubtech ecosystem\n\n**No prior Grubtech experience needed!** This AI assistant guides you through the entire process.\n\n---\n\n## ⚡ Quick Start - ONE Command!\n\n### Prerequisites\n\n- **Node.js 18+** - [Download](https://nodejs.org/)\n- **Claude Desktop or Claude Code** - [Download](https://claude.ai/)\n\n### Installation\n\nRun this **ONE command** in your terminal:\n\n```bash\nnpx @chanaka_nakandala/integration-agent init\n```\n\nThat's it! This installs:\n- ✅ AI-powered MCP server for Claude Code\n- ✅ 2 specialized AI agent personas (Developer & Business Analyst)\n- ✅ 20 production-ready code templates\n- ✅ Intelligent documentation search\n\n**Then:**\n1. Restart Claude Code\n2. Select an agent persona from the menu\n3. Start asking questions!\n\n---\n\n## 💬 How to Use\n\n### Example 1: Get Authentication Code\n\n**You ask Claude:**\n```\nHow do I authenticate with Grubtech API in TypeScript?\n```\n\n**Claude responds with:**\n```typescript\n// Complete working code with error handling\nconst API_KEY = 'your-api-key-here';\nconst PARTNER_ID = 'your-partner-id';\n\nasync function authenticate() {\n  const response = await fetch('https://api.grubtech.io/auth/token', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ apiKey: API_KEY, partnerId: PARTNER_ID })\n  });\n\n  if (!response.ok) {\n    throw new Error(`Authentication failed: ${response.statusText}`);\n  }\n\n  const { accessToken } = await response.json();\n  return accessToken;\n}\n```\n\n### Example 2: Search Documentation\n\n**You ask:**\n```\nHow do incoming orders work?\n```\n\n**Claude responds with:**\nRelevant documentation about order webhooks, payload structure, authentication requirements, and best practices - all extracted from official Grubtech docs.\n\n### Example 3: Planning Your Integration\n\n**You ask:**\n```\nHelp me plan my restaurant POS integration with Grubtech\n```\n\n**BA Agent responds:**\n- Asks discovery questions about your system\n- Identifies integration requirements\n- Creates a comprehensive project plan with architecture diagrams\n- Provides a handoff document for implementation\n\n---\n\n## 🤖 Two AI Agent Personas\n\n### 🔧 Developer Agent (Technical Implementation)\n\n**When to use:** You're ready to write code\n\n**What it does:**\n- Generates production-ready code in TypeScript, Python, Java, or cURL\n- Provides API specifications and technical details\n- Helps debug API errors with specific solutions\n- Technical, concise, code-first responses\n\n**Example questions:**\n- \"Generate Python code for menu synchronization\"\n- \"How do I handle order status updates in Java?\"\n- \"Show me cURL examples for item availability\"\n\n### 📊 Business Analyst Agent (Planning & Requirements)\n\n**When to use:** You're starting a new integration project\n\n**What it does:**\n- Asks discovery questions about your integration needs\n- Gathers comprehensive requirements\n- Creates project documentation with architecture diagrams\n- Provides process guidance and go-live checklists\n- Explanatory, question-driven, process-oriented responses\n\n**Example questions:**\n- \"Help me plan my integration with Grubtech\"\n- \"What do I need to know before starting?\"\n- \"Create a requirements document for my POS integration\"\n\n**💡 Best Practice:** Start with BA Agent for planning → Switch to Developer Agent for coding\n\n---\n\n## 🛠️ Common Integration Scenarios\n\nThis tool helps with all major Grubtech integration scenarios:\n\n### 1. **Authentication**\nGet access tokens to call Grubtech APIs securely.\n\n**Ask Claude:** *\"How do I authenticate?\"*\n\n### 2. **Menu Synchronization**\nPush your menu items, modifiers, and pricing to Grubtech.\n\n**Ask Claude:** *\"Generate code to sync my menu\"*\n\n### 3. **Receiving Orders**\nHandle incoming order webhooks from Grubtech when customers place orders.\n\n**Ask Claude:** *\"How do I receive orders from Grubtech?\"*\n\n### 4. **Order Status Updates**\nUpdate Grubtech when orders are accepted, prepared, or delivered.\n\n**Ask Claude:** *\"Show me how to update order status\"*\n\n### 5. **Item Availability**\nToggle menu items on/off when they're out of stock.\n\n**Ask Claude:** *\"How do I mark items as unavailable?\"*\n\n---\n\n## 📚 Available Code Templates\n\n20 production-ready templates for common operations:\n\n| Operation | TypeScript | Python | Java | cURL |\n|-----------|:----------:|:------:|:----:|:----:|\n| **Authentication** | ✅ | ✅ | ✅ | ✅ |\n| **Menu Sync** | ✅ | ✅ | ✅ | ✅ |\n| **Order Receive** | ✅ | ✅ | ✅ | ✅ |\n| **Order Status** | ✅ | ✅ | ✅ | ✅ |\n| **Item Availability** | ✅ | ✅ | ✅ | ✅ |\n\nEach template includes:\n- ✅ Complete working code\n- ✅ Error handling and logging\n- ✅ Type definitions (TypeScript/Python/Java)\n- ✅ Inline documentation\n- ✅ Placeholder markers for your credentials\n- ✅ Example usage\n\n---\n\n## 🔐 Privacy & Security\n\n- **100% Local** - All processing happens on your machine\n- **No Data Collection** - Zero telemetry or analytics\n- **No External API Calls** - Works offline (after initial doc scraping)\n- **Open Source** - Audit the code yourself\n- **No API Keys Required** - Templates use placeholders for your keys\n\nYour code and credentials **never leave your machine**.\n\n---\n\n## 🆘 Getting Help\n\n### Within Claude Code\nJust ask! The AI agents can help with:\n- API questions\n- Code errors\n- Integration planning\n- Best practices\n\n### External Resources\n- 📚 Grubtech API Docs: https://docs.grubtech.io\n- 🌐 Grubtech Website: https://www.grubtech.com\n- 📧 Email Support: support@grubtech.io\n\n### Common Questions\n\n**Q: Do I need a Grubtech account?**\nA: Yes, you'll need API credentials from Grubtech. Contact support@grubtech.io to get started.\n\n**Q: Which programming language should I use?**\nA: Use whatever your existing system is built with. This tool supports TypeScript, Python, Java, and cURL.\n\n**Q: Is this tool official from Grubtech?**\nA: This is a developer tool built to help with Grubtech integrations. For official support, contact Grubtech directly.\n\n**Q: Do I need to know Grubtech APIs beforehand?**\nA: No! The AI agents guide you through everything. Start with the BA Agent to learn the basics.\n\n---\n\n## 🚀 What You Can Build\n\nExamples of integrations developers have built:\n\n- **Restaurant POS Systems** - Sync menus, receive orders, update status\n- **Delivery Management Platforms** - Route orders, track deliveries, update statuses\n- **Kitchen Display Systems** - Receive orders, mark as prepared\n- **Inventory Management** - Update item availability based on stock\n- **Custom Ordering Websites** - Pull menus, create orders, track status\n- **Multi-Brand Aggregators** - Manage menus across multiple virtual brands\n\n---\n\n## 📝 Typical Integration Workflow\n\n### Phase 1: Planning (Use BA Agent)\n1. Ask: *\"Help me plan my integration\"*\n2. Answer discovery questions about your system\n3. Review generated requirements document\n\n### Phase 2: Setup\n1. Get API credentials from Grubtech\n2. Set up authentication\n3. Test connectivity\n\n### Phase 3: Implementation (Use Developer Agent)\n1. Implement menu synchronization\n2. Set up order webhook receiver\n3. Implement order status updates\n4. Add item availability management\n\n### Phase 4: Testing\n1. Test in Grubtech sandbox environment\n2. Validate data flows\n3. Handle edge cases\n\n### Phase 5: Go-Live\n1. Complete Grubtech certification\n2. Deploy to production\n3. Monitor integration health\n\n**💡 The AI agents guide you through each phase!**\n\n---\n\n## 💻 Example Session\n\n```\nYou: Help me start a POS integration with Grubtech\n\nBA Agent: I'll help you plan this integration. Let me ask a few questions:\n\n1. What type of system are you integrating?\n   - POS System, Delivery Platform, Kitchen Display, or Other?\n\n2. What's your tech stack?\n   - Language/framework you're using?\n\n3. What capabilities do you need?\n   - Menu sync, order receiving, status updates?\n\n[You answer the questions...]\n\nBA Agent: Based on your requirements, I've created a comprehensive\nintegration plan. See docs/integration-requirements.md\n\nNext step: Switch to \"Developer Agent\" to start implementation.\n\n---\n\nYou: [Switch to Developer Agent]\n    I have the requirements document. Let's start with authentication.\n\nDeveloper Agent: I'll generate TypeScript authentication code for you.\n[Provides complete working code with error handling...]\n```\n\n---\n\n## 🌟 Why Use This Tool?\n\n### Without This Tool:\n- ⏰ Spend hours searching documentation\n- 📄 Copy/paste code examples that don't quite fit\n- ❓ Get stuck on API errors with unclear messages\n- 🔄 Repeatedly ask the same questions\n\n### With This Tool:\n- ⚡ Get instant answers in Claude Code\n- 💻 Generate code tailored to your language\n- 🤖 AI agents guide you step-by-step\n- 📚 Smart search finds exactly what you need\n\n**Result:** Build integrations **5-10x faster** with fewer errors.\n\n---\n\n## 📄 License\n\nMIT © Grubtech\n\nFree to use for commercial and personal projects.\n\n---\n\n## 🔗 Links\n\n- **Grubtech Website:** https://www.grubtech.com\n- **API Documentation:** https://docs.grubtech.io\n- **Email Support:** support@grubtech.io\n- **NPM Package:** https://www.npmjs.com/package/@chanaka_nakandala/integration-agent\n\n---\n\n## 🎉 Ready to Start?\n\nInstall with ONE command:\n\n```bash\nnpx @chanaka_nakandala/integration-agent init\n```\n\nThen restart Claude Code and start building! 🚀\n\n---\n\n**Built for external developers integrating with Grubtech APIs**\n*Questions? Ask the AI agents in Claude Code or contact support@grubtech.io*\n","readmeFilename":"README.md","_rev":"1-420cd26bbd01176ec3619b138872b7c2"}