Title99/100
Get program
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Read the connected program: profile, status, commission terms, approval mode, partner counts, setup checklist, tracker status with 24-hour counts and the install snippet. Takes no input. tracking.tag unknown means not checked yet. Every item has a url to open it in Affitor. Use to check setup or install tracking; for partners use list_partners, for money get_commission_summary or get_billing.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
No input fields.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema79/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"name",
"slug",
"status",
"website",
"category",
"tagline",
"description",
"currency",
"approval",
"pending_applications",
"partners",
"commission",
"checklist",
"tracking",
"install",
"url"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Program id."
},
"url": {
"type": "string",
"description": "Opens the program in the Affitor dashboard."
},
"name": {
"anyOf": [
{
"type": "string",
"maxLength": 280
},
{
"type": "null"
}
],
"description": "Program name."
},
"slug": {
"anyOf": [
{
"type": "string",
"maxLength": 280
},
{
"type": "null"
}
],
"description": "The program part of its public page address."
},
"status": {
"type": [
"string",
"null"
],
"description": "Program status: draft, active (not listed yet), live (active and listed on the marketplace), paused or archived."
},
"install": {
"type": "object",
"required": [
"script_tag",
"npm_install",
"npm_files",
"where",
"verify"
],
"properties": {
"where": {
"type": "string",
"description": "Where on the website the tracker goes."
},
"verify": {
"type": "string",
"description": "How to check that the tracker works."
},
"npm_files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "What to put in it."
},
"path": {
"type": "string",
"description": "File to create or edit."
}
},
"additionalProperties": false
},
"description": "The files to add with the npm install."
},
"script_tag": {
"type": "string",
"description": "The tracker script tag to paste into the website."
},
"npm_install": {
"type": "string",
"description": "The command that installs the tracker package, for apps that use npm instead."
}
},
"description": "How to install the tracker.",
"additionalProperties": false
},
"tagline": {
"anyOf": [
{
"type": "string",
"maxLength": 280
},
{
"type": "null"
}
],
"description": "One-line pitch shown to partners."
},
"website": {
"anyOf": [
{
"type": "string",
"maxLength": 280
},
{
"type": "null"
}
],
"description": "The brand's website."
},
"approval": {
"type": [
"string",
"null"
],
"description": "How partner applications are approved: auto or manual; null until chosen."
},
"category": {
"type": [
"string",
"null"
],
"description": "Program category."
},
"currency": {
"type": "string",
"description": "Currency of the program, a three-letter code."
},
"partners": {
"type": "number",
"description": "Partners in the program."
},
"tracking": {
"type": "object",
"required": [
"counts_24h",
"tag"
],
"properties": {
"tag": {
"type": "string",
"description": "Whether the tracker script was found on the website: found, not_found, fetch_failed, invalid_url, blocked_private_address or unknown."
},
"counts_24h": {
"type": "object",
"required": [
"clicks",
"leads",
"leads_provisional",
"sales",
"sales_cents"
],
"properties": {
"leads": {
"type": "number",
"description": "Sign-ups tracked in the last 24 hours."
},
"sales": {
"type": "number",
"description": "Sales tracked in the last 24 hours."
},
"clicks": {
"type": "number",
"description": "Referral clicks tracked in the last 24 hours."
},
"sales_cents": {
"type": "number",
"description": "Value of those sales in the program currency, in cents; sales in another currency are left out, not converted."
},
"leads_provisional": {
"type": "number",
"description": "Sign-ups in the last 24 hours that still wait for confirmation."
}
},
"description": "What the tracker recorded in the last 24 hours.",
"additionalProperties": false
}
},
"description": "Tracker status on the website and what it recorded in the last 24 hours.",
"additionalProperties": false
},
"checklist": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"done"
],
"properties": {
"id": {
"type": "string",
"description": "Setup step: business-details, approval-mode, commission, branding, click-tracking, lead-tracking, payment-tracking or share-program."
},
"done": {
"type": "boolean",
"description": "True when the step is done."
}
},
"additionalProperties": false
},
"description": "The setup steps and whether each is done; the program is ready when all are done."
},
"truncated": {
"type": "array",
"items": {
"type": "string"
},
"description": "Paths of text fields that were cut to 280 characters."
},
"commission": {
"type": "object",
"required": [
"type",
"rate_pct",
"fixed_cents",
"duration_months",
"attribution_days",
"hold_days"
],
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "Commission model: one_time, recurring or lifetime (a share of each sale), cpc (per click) or cpl (per lead); null until set."
},
"rate_pct": {
"type": [
"number",
"null"
],
"description": "For the sale models: the share of each sale paid to the partner, in percent."
},
"hold_days": {
"type": [
"number",
"null"
],
"description": "Days a new commission is held before it can be approved automatically."
},
"fixed_cents": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "For cpc and cpl: the fixed amount per click or per lead, in cents of the program currency."
},
"duration_months": {
"type": [
"number",
"null"
],
"description": "For recurring: for how many months payments earn commission."
},
"attribution_days": {
"type": [
"number",
"null"
],
"description": "How many days after a click a sale still counts for the partner."
}
},
"description": "What partners earn.",
"additionalProperties": false
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 280
},
{
"type": "null"
}
],
"description": "The program description shown to partners."
},
"pending_applications": {
"type": "number",
"description": "Partner applications waiting for a decision."
}
},
"additionalProperties": false
}