check_my_tier
Determine your current Kiln subscription tier and receive a plain-English explanation of why you're on that plan.
Instructions
Check the user's current Kiln subscription tier (Free / Pro / Business / Enterprise) and explain WHY they're on it.
Use this whenever the user asks any tier / plan / subscription /
paywall / access question — for example: "what tier am I on",
"why does it say I need Pro", "do I have to pay for this",
"what's my plan", "why isn't this Pro feature working", "did
my subscription not activate", "what's the difference between
Free and Pro", "I just paid but I'm still seeing free tier",
"can I use the texture engine", "do I have access to fleet
management", "what unlocks at Business", "how do I upgrade".
Walks the live tier-resolution chain on the user's machine
(KILN_LICENSE_KEY env var → ~/.kiln/license file → OAuth
session at ~/.kiln/auth_tokens.json → cached entitlement →
free-tier fallback) and reports:
- effective_tier: one of 'free', 'pro', 'business', 'enterprise'
- resolution_chain: list of every step with which matched
- matched_source: which step actually determined the tier
- agent_summary: a plain-English one-liner you can show
the user verbatim
- pricing_url: link to send the user if they want to upgrade
No arguments. Free-tier safe — does NOT require a license
to call. Available to every user.
Common interpretation:
- effective_tier="free", matched_source="kiln_pro_install":
kiln-pro not installed on this machine. User can still
use Pro features via api.kiln3d.com if signed in.
- effective_tier="free", matched_source="default":
kiln-pro installed but no auth — needs `kiln login` or
KILN_LICENSE_KEY.
- effective_tier="pro" (or higher) with matched_source=
"license_manager_resolve" and "oauth_session" matched=True
in the chain: user is signed in via OAuth and the
entitlement on file gives them this tier.
Returns:
dict with success/effective_tier/resolution_chain/
matched_source/agent_summary/tier_rank/pricing_url.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||