Introduction

ZiadaPOS Documentation

ZiadaPOS is a complete point-of-sale and shop management system built for Tanzanian businesses. It consists of three main components:

ComponentTech StackPurpose
REST APIGo + Gin + GORM + PostgreSQLBackend serving all business logic
MCP AgentPython + FastMCP + LLMNatural-language AI assistant
DocsNext.js + NextraThis documentation site

Quick Start

For API Consumers

  1. Register an account via POST /api/v1/auth/register
  2. Login via POST /api/v1/auth/login to get JWT tokens
  3. Use the access_token in Authorization: Bearer <token> header
  4. Start making authenticated requests

For Agent Users

  1. The agent exposes an MCP endpoint at /mcp
  2. Or use the HTTP bridge at POST /ask with {"question": "..."} queries
  3. The agent supports both English and Swahili

Base URLs

EnvironmentAPIAgent
Localhttp://localhost:8080/api/v1http://localhost:8081
Productionhttps://api.ziadapos.com/api/v1https://agent.ziadapos.com

Documentation Structure

  • REST API - Complete API reference with all 152 endpoints
  • MCP Agent - AI agent documentation with 111 tools
  • Architecture - System design and data flow
Overview