# 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

> [!NOTE]
> Haszno is in **Developer preview**. The API has no version prefix. Breaking changes may occur without notice. See [Changelog and versioning](changelog.md) 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](authentication.md) for where Bearer tokens are accepted today.

See [Authentication](authentication.md) for exact details on each mechanism.

## Base URL

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

## Browse the documentation

<div class="entry-cards">
  <a class="entry-card" href="quickstart.html">
    <span class="card-icon" aria-hidden="true">↗</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>Quick start</strong>
    <p>Make your first API request in under two minutes — no credentials needed.</p>
  </a>
  <a class="entry-card" href="api-reference.html">
    <span class="card-icon" aria-hidden="true">{ }</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>API reference</strong>
    <p>Every public endpoint: parameters, response fields, and copy-pasteable examples.</p>
  </a>
  <a class="entry-card" href="agents.html">
    <span class="card-icon" aria-hidden="true">&gt;_</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>CLI and MCP</strong>
    <p>Install the CLI or MCP server and start automating your shop from a terminal or an AI agent.</p>
  </a>
  <a class="entry-card" href="authentication.html">
    <span class="card-icon" aria-hidden="true">#</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>Authentication</strong>
    <p>How credentials work — from no-auth demo reads to API keys and Bearer tokens.</p>
  </a>
</div>