---
title: Agent quickstart
description: Connect the factory as a tool, get a quote, place an order, verify ROI — end to end.
date: 2026-07-17
audience: technical
category: reference
---
The factory is an MCP server. Everything below is also discoverable at /.well-known/mcp.json, /llms.txt and /facts.json.

## Connect (stdio)
Add tng-factory to your MCP config: command `fastmcp`, args `run src/tng/mcp/server.py`. Start every session with **get_capabilities** — it is the machine-readable evaluation surface (materials, limits, pricing basis, locales, sandbox flag).

## Evaluate before auth
POST /v1/try/review-stand needs no key: send line1/line2 (and optional logo), poll /v1/tasks/{id} or stream /v1/tasks/{id}/stream (SSE), and you get a preview URL plus a deterministic quote. Rate-limited 10/day/IP.

## Buy
- **quote** — machine-readable price for a mesh or product; pass ship_to_country (ISO-2) for regional currency.
- **order_production** — the purchase leg; pass your user_id so the order lands in your metrics. Sandbox until checkout keys are live.
- **get_credit_topup_link / get_credit_balance** — the credit buy leg without leaving the tool surface.
- Retries: pass request_id on create tools; retries are safe.

## Operate and re-buy
**get_metrics** (or GET /v1/metrics with X-API-Key) returns your orders, paid spend, objects in the wild, scan totals and credit balance — verify value on evidence, then re-buy.

## Earn
**join_affiliate_program** mints your referral link (20% of every paid referred order, in credits). **publish_listing** puts your model on the marketplace at a 30% creator royalty. Both stack: creation and distribution are paid separately.