Package Exports

@chanaka_nakandala/integration-agent

Readme

Grubtech Integration Assistant

AI-powered integration helper for Claude Code Get instant answers, generate code, and build Grubtech integrations faster

📖 What is This?

If 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:

✅ Instant answers to API questions (no more searching docs)
✅ Production-ready code in TypeScript, Python, Java, or cURL
✅ AI guidance from specialized Developer and Business Analyst agents
✅ Smart documentation search using natural language

Example: Instead of searching docs for 30 minutes, just ask: "How do I authenticate with Grubtech?" → Get working code instantly.

🍔 What is Grubtech?

Grubtech is a leading cloud-based restaurant technology platform that powers:

Cloud kitchens and virtual restaurants
Multi-channel online ordering (delivery apps, web, mobile)
Menu management across platforms
Order aggregation and kitchen operations

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.

Official Resources:

🌐 Website: https://www.grubtech.com
📚 API Documentation: https://docs.grubtech.io
📧 Support: support@grubtech.io

👥 Who Should Use This?

This tool is perfect for external developers who are:

✅ Restaurant/POS Developers - Integrating your point-of-sale system with Grubtech ✅ Delivery Platform Engineers - Building order sync between your platform and Grubtech ✅ Cloud Kitchen Tech Teams - Connecting kitchen management systems ✅ Integration Consultants - Building custom integrations for clients ✅ Technical Partners - Developing apps in the Grubtech ecosystem

No prior Grubtech experience needed! This AI assistant guides you through the entire process.

⚡ Quick Start - ONE Command!

Prerequisites

Node.js 18+ - Download
Claude Desktop or Claude Code - Download

Installation

Run this ONE command in your terminal:

npx @chanaka_nakandala/integration-agent init

That's it! This installs:

✅ AI-powered MCP server for Claude Code
✅ 2 specialized AI agent personas (Developer & Business Analyst)
✅ 20 production-ready code templates
✅ Intelligent documentation search

Then:

Restart Claude Code
Select an agent persona from the menu
Start asking questions!

💬 How to Use

Example 1: Get Authentication Code

You ask Claude:

How do I authenticate with Grubtech API in TypeScript?

Claude responds with:

// Complete working code with error handling
const API_KEY = 'your-api-key-here';
const PARTNER_ID = 'your-partner-id';

async function authenticate() {
  const response = await fetch('https://api.grubtech.io/auth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ apiKey: API_KEY, partnerId: PARTNER_ID })
  });

  if (!response.ok) {
    throw new Error(`Authentication failed: ${response.statusText}`);
  }

  const { accessToken } = await response.json();
  return accessToken;
}

Example 2: Search Documentation

You ask:

How do incoming orders work?

Claude responds with: Relevant documentation about order webhooks, payload structure, authentication requirements, and best practices - all extracted from official Grubtech docs.

Example 3: Planning Your Integration

You ask:

Help me plan my restaurant POS integration with Grubtech

BA Agent responds:

Asks discovery questions about your system
Identifies integration requirements
Creates a comprehensive project plan with architecture diagrams
Provides a handoff document for implementation

🤖 Two AI Agent Personas

🔧 Developer Agent (Technical Implementation)

When to use: You're ready to write code

What it does:

Generates production-ready code in TypeScript, Python, Java, or cURL
Provides API specifications and technical details
Helps debug API errors with specific solutions
Technical, concise, code-first responses

Example questions:

"Generate Python code for menu synchronization"
"How do I handle order status updates in Java?"
"Show me cURL examples for item availability"

📊 Business Analyst Agent (Planning & Requirements)

When to use: You're starting a new integration project

What it does:

Asks discovery questions about your integration needs
Gathers comprehensive requirements
Creates project documentation with architecture diagrams
Provides process guidance and go-live checklists
Explanatory, question-driven, process-oriented responses

Example questions:

"Help me plan my integration with Grubtech"
"What do I need to know before starting?"
"Create a requirements document for my POS integration"

💡 Best Practice: Start with BA Agent for planning → Switch to Developer Agent for coding

🛠️ Common Integration Scenarios

This tool helps with all major Grubtech integration scenarios:

1. Authentication

Get access tokens to call Grubtech APIs securely.

Ask Claude: "How do I authenticate?"

Push your menu items, modifiers, and pricing to Grubtech.

Ask Claude: "Generate code to sync my menu"

3. Receiving Orders

Handle incoming order webhooks from Grubtech when customers place orders.

Ask Claude: "How do I receive orders from Grubtech?"

4. Order Status Updates

Update Grubtech when orders are accepted, prepared, or delivered.

Ask Claude: "Show me how to update order status"

5. Item Availability

Toggle menu items on/off when they're out of stock.

Ask Claude: "How do I mark items as unavailable?"

📚 Available Code Templates

20 production-ready templates for common operations:

Operation	TypeScript	Python	Java	cURL
Authentication	✅	✅	✅	✅
Menu Sync	✅	✅	✅	✅
Order Receive	✅	✅	✅	✅
Order Status	✅	✅	✅	✅
Item Availability	✅	✅	✅	✅

Each template includes:

✅ Complete working code
✅ Error handling and logging
✅ Type definitions (TypeScript/Python/Java)
✅ Inline documentation
✅ Placeholder markers for your credentials
✅ Example usage

🔐 Privacy & Security

100% Local - All processing happens on your machine
No Data Collection - Zero telemetry or analytics
No External API Calls - Works offline (after initial doc scraping)
Open Source - Audit the code yourself
No API Keys Required - Templates use placeholders for your keys

Your code and credentials never leave your machine.

🆘 Getting Help

Within Claude Code

Just ask! The AI agents can help with:

API questions
Code errors
Integration planning
Best practices

External Resources

📚 Grubtech API Docs: https://docs.grubtech.io
🌐 Grubtech Website: https://www.grubtech.com
📧 Email Support: support@grubtech.io

Common Questions

Q: Do I need a Grubtech account? A: Yes, you'll need API credentials from Grubtech. Contact support@grubtech.io to get started.

Q: Which programming language should I use? A: Use whatever your existing system is built with. This tool supports TypeScript, Python, Java, and cURL.

Q: Is this tool official from Grubtech? A: This is a developer tool built to help with Grubtech integrations. For official support, contact Grubtech directly.

Q: Do I need to know Grubtech APIs beforehand? A: No! The AI agents guide you through everything. Start with the BA Agent to learn the basics.

🚀 What You Can Build

Examples of integrations developers have built:

Restaurant POS Systems - Sync menus, receive orders, update status
Delivery Management Platforms - Route orders, track deliveries, update statuses
Kitchen Display Systems - Receive orders, mark as prepared
Inventory Management - Update item availability based on stock
Custom Ordering Websites - Pull menus, create orders, track status
Multi-Brand Aggregators - Manage menus across multiple virtual brands

📝 Typical Integration Workflow

Phase 1: Planning (Use BA Agent)

Ask: "Help me plan my integration"
Answer discovery questions about your system
Review generated requirements document

Phase 2: Setup

Get API credentials from Grubtech
Set up authentication
Test connectivity

Phase 3: Implementation (Use Developer Agent)

Implement menu synchronization
Set up order webhook receiver
Implement order status updates
Add item availability management

Phase 4: Testing

Test in Grubtech sandbox environment
Validate data flows
Handle edge cases

Phase 5: Go-Live

Complete Grubtech certification
Deploy to production
Monitor integration health

💡 The AI agents guide you through each phase!

💻 Example Session

You: Help me start a POS integration with Grubtech

BA Agent: I'll help you plan this integration. Let me ask a few questions:

1. What type of system are you integrating?
   - POS System, Delivery Platform, Kitchen Display, or Other?

2. What's your tech stack?
   - Language/framework you're using?

3. What capabilities do you need?
   - Menu sync, order receiving, status updates?

[You answer the questions...]

BA Agent: Based on your requirements, I've created a comprehensive
integration plan. See docs/integration-requirements.md

Next step: Switch to "Developer Agent" to start implementation.

---

You: [Switch to Developer Agent]
    I have the requirements document. Let's start with authentication.

Developer Agent: I'll generate TypeScript authentication code for you.
[Provides complete working code with error handling...]

🌟 Why Use This Tool?

Without This Tool:

⏰ Spend hours searching documentation
📄 Copy/paste code examples that don't quite fit
❓ Get stuck on API errors with unclear messages
🔄 Repeatedly ask the same questions

With This Tool:

⚡ Get instant answers in Claude Code
💻 Generate code tailored to your language
🤖 AI agents guide you step-by-step
📚 Smart search finds exactly what you need

Result: Build integrations 5-10x faster with fewer errors.

📄 License

MIT © Grubtech

Free to use for commercial and personal projects.

🔗 Links

Grubtech Website: https://www.grubtech.com
API Documentation: https://docs.grubtech.io
Email Support: support@grubtech.io
NPM Package: https://www.npmjs.com/package/@chanaka_nakandala/integration-agent

🎉 Ready to Start?

Install with ONE command:

npx @chanaka_nakandala/integration-agent init

Then restart Claude Code and start building! 🚀

Built for external developers integrating with Grubtech APIs Questions? Ask the AI agents in Claude Code or contact support@grubtech.io

@chanaka_nakandala/integration-agent