TTYINV FOR AGENTS

Your agent can draft.
You keep the source.

Create portable ttyinv Markdown and validate it for free. Every agent call requires a revocable agent token. Hosted HTML, PDF, and PNG rendering also requires an active lifetime purchase.

GET STARTED

Three steps, then hand it to your agent.

Install the portable skill

Each harness reads skills from its own directory. Set TTYINV_SKILL_DIR to that directory. The command downloads the archive, verifies the checksum, prints the contents, then extracts the skill.

: "${TTYINV_SKILL_DIR:?Set TTYINV_SKILL_DIR to the skill directory of your harness}" &&
ttyinv_skill_tmp="$(mktemp -d)" &&
trap 'test -n "$ttyinv_skill_tmp" && rm -rf -- "$ttyinv_skill_tmp"' EXIT &&
curl --fail --silent --show-error --location "https://ttyinv.com/skills/ttyinv-invoice.tar.gz" -o "$ttyinv_skill_tmp/ttyinv-invoice.tar.gz" &&
curl --fail --silent --show-error --location "https://ttyinv.com/skills/ttyinv-invoice.tar.gz.sha256" -o "$ttyinv_skill_tmp/ttyinv-invoice.tar.gz.sha256" &&
(cd "$ttyinv_skill_tmp" && if command -v sha256sum >/dev/null 2>&1; then sha256sum -c ttyinv-invoice.tar.gz.sha256; else shasum -a 256 -c ttyinv-invoice.tar.gz.sha256; fi) &&
test "$(tar -tzf "$ttyinv_skill_tmp/ttyinv-invoice.tar.gz")" = "$(printf 'ttyinv-invoice/\nttyinv-invoice/SKILL.md')" &&
test "$(tar -tzvf "$ttyinv_skill_tmp/ttyinv-invoice.tar.gz" | cut -c1 | tr -d '\n')" = "d-" &&
tar -xzOf "$ttyinv_skill_tmp/ttyinv-invoice.tar.gz" ttyinv-invoice/SKILL.md > "$ttyinv_skill_tmp/SKILL.md" &&
test -s "$ttyinv_skill_tmp/SKILL.md" &&
cat "$ttyinv_skill_tmp/SKILL.md" &&
mkdir -p "$TTYINV_SKILL_DIR/ttyinv-invoice" &&
cp "$ttyinv_skill_tmp/SKILL.md" "$TTYINV_SKILL_DIR/ttyinv-invoice/SKILL.md.tmp" &&
mv "$TTYINV_SKILL_DIR/ttyinv-invoice/SKILL.md.tmp" "$TTYINV_SKILL_DIR/ttyinv-invoice/SKILL.md"

Download skill (.tar.gz)Checksum (.sha256)Read SKILL.md

02
Create a private token
Sign in with GitHub on the hosted app, choose an expiry, then store the one-time value in TTYINV_AGENT_TOKEN.
Manage tokens on app.ttyinv.com
03
Connect and create
Use MCP for tool discovery, or call the same strict contract over REST. Fetch the live contract instead of guessing fields.
Open the quickstart

CHOOSE A PATH

One contract, three ways to work.

MCP

Let tools describe themselves

Streamable HTTP exposes create_invoice, validate_invoice, and render_invoice.

{
  "mcpServers": {
    "ttyinv": {
      "type": "http",
      "url": "https://app.ttyinv.com/mcp",
      "headers": { "Authorization": "Bearer ${TTYINV_AGENT_TOKEN}" }
    }
  }
}

Field names vary by harness. Some harnesses name the block servers, or split the URL and the transport. Keep the endpoint, the transport, and the Authorization header. Read the configuration reference of your harness.

https://app.ttyinv.com/mcp

API

Use plain authenticated JSON

Create at https://app.ttyinv.com/api/v1/invoices, then validate and render from the returned source. Discovery and the schema are public. Every invoice operation requires the token.

# Paste the token at the silent prompt. The shell keeps it out of history.
read -r -s TTYINV_AGENT_TOKEN && export TTYINV_AGENT_TOKEN
# Discovery lists every operation, tool, status, and purchase rule.
curl --fail --silent --show-error "https://app.ttyinv.com/api/v1"
# The schema envelope is the authoritative input and output contract.
curl --fail --silent --show-error "https://app.ttyinv.com/api/v1/invoices/schema"

REST contracts and examples

CLI

Keep everything local

The Python CLI validates and renders files without sending invoice contents to ttyinv. It is the right path for local-only data.

ttyinv init invoice.md
ttyinv lint invoice.md --strict
ttyinv render invoice.md --format both

CLI installation and full guide

CAPABILITY MATRIX

What each path gives your agent.

Each harness chooses its own skill directory and its own configuration file. ttyinv states the contract; your harness states the file names.

Capabilities of each agent path
Capability	MCP	API	CLI	Portable skill
Tool discovery	`tools/list`	`GET https://app.ttyinv.com/api/v1`	`ttyinv --help`	Describes both transports
Create and validate	`create_invoice`	`POST https://app.ttyinv.com/api/v1/invoices`	`ttyinv init`	Guides the workflow
Hosted HTML, PDF, PNG	`render_invoice`	`POST https://app.ttyinv.com/api/v1/invoices/render`	Renders on your machine	Documents hosted rendering
Purchase	Render only	Render only	Not required	Reports status 402
Agent token	Required	Required	Not used	Explains token use
Invoice content	Crosses the network	Crosses the network	Stays local	States the boundary
Setup	Configuration file	`TTYINV_AGENT_TOKEN`	Python package	Names skill directory

AUTHENTICATION LIVES ON THE APP

Sign in before handing out a key.

GitHub identifies the owner of each expiring, revocable token. The public website is static; token creation, revocation, and authenticated requests stay on the app runtime.

Continue with GitHub