# STG Portal

> Print-fleet monitoring and analytics. Install a lightweight agent (Print Tracker
> Pro) and STG Portal shows page counts, costs, supply levels, and a full Business
> Review for your fleet.

This file documents how an automated agent can onboard end-to-end.

## Fastest path (keyless, prospects only)

One call creates an account and returns session tokens + a silent install command.
Only works for emails NOT already on file with STG, and only when enabled on the
deployment.

  POST https://portal.scott.tech/api/agent/signup
  Content-Type: application/json
  { "email": "you@company.com", "password": "<8+ chars>", "company": "Company Inc" }

On success (201) the response includes "access_token" and "install.windows" /
"install.linux". Run the install command (see below). If it returns 409
"recognized_email", use the standard path instead.

## Standard path

1. Sign up via Supabase Auth and confirm the email:
     POST https://seoouplbhzfwuipvzqeu.supabase.co/auth/v1/signup
     apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InNlb291cGxiaHpmd3VpcHZ6cWV1Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODAwMDcxMDEsImV4cCI6MjA5NTU4MzEwMX0.8q1C1xGB2fyNZkJPk06DvfPlEf0CrKRZjPhEjJ2_a5A
     { "email": "...", "password": "...", "data": { "company_name": "Company Inc" } }
   Then complete email confirmation (click the link, or read the inbox).

2. Sign in to get an access token:
     POST https://seoouplbhzfwuipvzqeu.supabase.co/auth/v1/token?grant_type=password
     apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InNlb291cGxiaHpmd3VpcHZ6cWV1Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODAwMDcxMDEsImV4cCI6MjA5NTU4MzEwMX0.8q1C1xGB2fyNZkJPk06DvfPlEf0CrKRZjPhEjJ2_a5A
     { "email": "...", "password": "..." }

3. Provision a workspace + get the install command:
     POST https://portal.scott.tech/api/provision
     Authorization: Bearer <access_token>
     { "company": "Company Inc" }   # optional if set at signup

   200 -> response has "download_url" (a pre-configured .msi) and
   "install.windows" / "install.linux" (silent commands). "datalink_code" is the
   PT entity id. GET https://portal.scott.tech/api/provision returns the machine-readable contract.

## Install the agent

Two options, both with the Datalink Code already baked in (nothing to configure):
- One-click: open "download_url" and run the downloaded installer.
- Silent/scriptable: run "install.windows" in an elevated PowerShell (Run as
  administrator), or "install.linux" in a terminal with sudo.

Once the agent reports in, the fleet's data appears at https://portal.scott.tech/overview.

## MCP server (for MCP-aware agents)

If your agent speaks the Model Context Protocol, connect directly instead of calling
the HTTP endpoints by hand:

  Endpoint:  https://portal.scott.tech/api/mcp
  Transport: Streamable HTTP (stateless)
  Auth:      Authorization: Bearer <Supabase access token>  (per call)

Tools:
- sign_up        (no token) — create an account + provision a workspace; returns a
                  ready-to-use token (it already carries your organization) + install command.
- provision      (bearer)   — provision a workspace + get the silent install command.
- fleet_status   (bearer)   — fleet KPIs (devices, volume, cost, security, utilization).
- list_alerts    (bearer)   — open fleet-health alerts, most severe first.
- business_review(bearer)   — KPIs + ranked recommendations for your fleet.

Call sign_up first; pass the returned access_token as the bearer token for the rest.

## Machine-readable API

OpenAPI spec: https://portal.scott.tech/openapi.json

## Help

Prefer a human? https://portal.scott.tech has a "talk to a human" option on the install screen.