Getting started

Overview

Haszno is a Hungarian dropshipping SaaS in developer preview. It exposes an HTTP API, a CLI, an MCP server, and an agent skill for integrators and AI agents.

What Haszno does

Haszno connects Hungarian webshop owners with dropshipping suppliers. It monitors competitor market prices, computes a recommended selling price for each product, and automatically updates listings in connected webshops. It also forwards customer orders to the matching supplier.

As a developer or integrator, you interact with Haszno through four surfaces:

Surface What it is Best for
HTTP API REST API at https://haszno.com Custom integrations, webhooks, server-side automation
CLI haszno command-line tool (Node.js, runs via npx) Shell scripts, cron jobs, Codex, Cursor terminal
MCP server stdio MCP server (haszno-mcp) Claude Code, Claude Desktop, any MCP-compatible AI client
Agent skill Guidance files installed into Claude Code Teaches an AI agent the domain model, safety rules, and workflow recipes

What you can do today

Haszno is in Developer preview. The API has no version prefix. Breaking changes may occur without notice. See Changelog and versioning for the graduation plan.

Without any credentials you can read all public demo endpoints — categories, products, pricing data, supplier list, impact summary, settings, and more. All data returned is synthetic sample data generated for the demo. The /api/settings and /api/impact responses include a "demo": true field; other demo endpoints return their data without this flag.

With a session (you can register at https://haszno.com) you can manage your own API Bearer tokens, but on the hosted demo at haszno.com data routes continue to serve synthetic demo data. Full per-shop data is not yet available to self-registered accounts.

With HTTP Basic credentials from the Haszno team you get full read and write access to the shared demo deployment, including order ingestion, rule management, and feed imports.

On a self-hosted instance you protect the API with your own key: set HASZNO_API_KEY on the server, and clients (including the CLI and the MCP server) send it in the x-api-key header. See Authentication for where Bearer tokens are accepted today.

See Authentication for exact details on each mechanism.

Base URL

All examples in this documentation use https://haszno.com as the base URL.

Browse the documentation

Quick start

Make your first API request in under two minutes — no credentials needed.

API reference

Every public endpoint: parameters, response fields, and copy-pasteable examples.

CLI and MCP

Install the CLI or MCP server and start automating your shop from a terminal or an AI agent.

Authentication

How credentials work — from no-auth demo reads to API keys and Bearer tokens.