How kaavyabaranwal/merchant-agent-connector works
This is a read-only Zoho Inventory MCP connector: an MCP client invokes registered item or sales-order tools, the matching connector normalizes Zoho responses, and the Zoho client performs authenticated API requests with centralized error handling and rate-limit retries. OAuth token exchange and the external Zoho services are shown as distinct dependencies. The graph focuses on runtime behavior; seed and token-generation scripts are setup utilities, not product workflow. Edges are limited to relationships visible in the README or excerpted source.
Main entry points: client.ts Zoho API client · server.ts MCP tool server · items.ts Item tools · sales-orders.ts Sales-order tools
Components 7
MCP Interface
- MCP tool server
src/mcp/server.ts
Inventory and Orders
- Item tools
src/connectors/zoho/items.ts - Sales-order tools
src/connectors/zoho/sales-orders.ts
Zoho Integration
- Zoho API client
src/connectors/zoho/client.ts - Zoho OAuth service
- Zoho Inventory API
Other components
- MCP client / agent
Connections 7
- MCP client / agent → MCP tool server: invokes tools
README.md - MCP tool server → Item tools: dispatches item calls
src/mcp/server.ts - MCP tool server → Sales-order tools: dispatches order calls
src/mcp/server.ts - Item tools → Zoho API client: requests item data
src/connectors/zoho/items.ts - Sales-order tools → Zoho API client: requests order data
src/connectors/zoho/sales-orders.ts - Zoho API client → Zoho OAuth service: exchanges refresh token
src/connectors/zoho/client.ts - Zoho API client → Zoho Inventory API: fetches inventory data
src/connectors/zoho/client.ts