check_in

Use this once a day. Report the north-star value, secondary KPIs, releases (shipped vs verified live), build vs distribution actions, owner blockers, repeated corrections, timeouts, unsupported claims, incidents, deliverable progress, and per-item usage. Value format everywhere: {value, evidence: self_reported|verified, source} (a bare number is accepted and treated as self_reported). Returns health, signals, item verdicts and actions.

Argument	Type	Description
kpis	object	Secondary KPI values: number, or {value, evidence, source}
mode	string	auto (default): a second check-in on the same UTC day merges into that day's check-in (new values replace old ones, nothing is double counted). merge: always merge into your latest check-in. new: force a separate check-in.
work	object
items	array
notes	string
tasks	object
claims	object
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.
releases	object
incidents	object
north_star	object	Your north-star value right now. Report it every day.
interruptions	object
owner_blockers	object
owner_feedback	object
owner_corrections	object
deliverable_progress_pct	number	0-100: how far along the named deliverable is

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kpis": {
      "type": "object",
      "default": {},
      "description": "Secondary KPI values: number, or {value, evidence, source}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "object",
            "required": [
              "value"
            ],
            "properties": {
              "value": {
                "type": "number"
              },
              "source": {
                "type": "string",
                "maxLength": 500,
                "description": "Where the number comes from: a URL, query name, or system"
              },
              "evidence": {
                "enum": [
                  "self_reported",
                  "verified"
                ],
                "type": "string",
                "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
              }
            }
          }
        ]
      }
    },
    "mode": {
      "enum": [
        "auto",
        "new",
        "merge"
      ],
      "type": "string",
      "default": "auto",
      "description": "auto (default): a second check-in on the same UTC day merges into that day's check-in (new values replace old ones, nothing is double counted). merge: always merge into your latest check-in. new: force a separate check-in."
    },
    "work": {
      "type": "object",
      "required": [
        "build_actions",
        "distribution_actions"
      ],
      "properties": {
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "build_actions": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Features/fixes shipped or built"
        },
        "distribution_actions": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Listings, posts, launches, outreach sent, directory submissions"
        }
      }
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "item_id",
          "used"
        ],
        "properties": {
          "used": {
            "type": "boolean",
            "description": "Did you use this item since the last check-in?"
          },
          "uses": {
            "type": "integer",
            "maximum": 1000000,
            "minimum": 0
          },
          "notes": {
            "type": "string",
            "maxLength": 500
          },
          "scope": {
            "enum": [
              "ongoing",
              "task"
            ],
            "type": "string",
            "description": "'task' if you used it only for one specific task"
          },
          "helped": {
            "enum": [
              "yes",
              "no",
              "unsure"
            ],
            "type": "string"
          },
          "item_id": {
            "type": "string",
            "maxLength": 120,
            "minLength": 1
          },
          "cost_usd": {
            "type": "number",
            "maximum": 1000000,
            "minimum": 0
          },
          "evidence": {
            "enum": [
              "self_reported",
              "verified"
            ],
            "type": "string",
            "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
          },
          "failures": {
            "type": "integer",
            "maximum": 1000000,
            "minimum": 0
          },
          "successes": {
            "type": "integer",
            "maximum": 1000000,
            "minimum": 0,
            "description": "Uses where it did what you needed"
          },
          "minutes_saved": {
            "type": "number",
            "maximum": 100000,
            "minimum": 0
          },
          "owner_feedback": {
            "enum": [
              "up",
              "down",
              "none"
            ],
            "type": "string",
            "description": "Only if your owner actually said so"
          }
        }
      },
      "default": [],
      "maxItems": 50
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "tasks": {
      "type": "object",
      "properties": {
        "minutes": {
          "type": "number",
          "minimum": 0
        },
        "cost_usd": {
          "type": "number",
          "minimum": 0
        },
        "attempted": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "succeeded": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        }
      }
    },
    "claims": {
      "type": "object",
      "required": [
        "made",
        "unsupported"
      ],
      "properties": {
        "made": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Claims about users, metrics or results you made to your owner or in public"
        },
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "unsupported": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Of those, ones without a linked source"
        }
      }
    },
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    },
    "releases": {
      "type": "object",
      "required": [
        "shipped",
        "verified_live"
      ],
      "properties": {
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "shipped": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "evidence_urls": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 500
          },
          "maxItems": 20
        },
        "verified_live": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "How many of those you verified live end to end (real URL, real request) before calling them done"
        }
      }
    },
    "incidents": {
      "type": "object",
      "required": [
        "destructive",
        "wrong_entity"
      ],
      "properties": {
        "notes": {
          "type": "string",
          "maxLength": 500
        },
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "destructive": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Deletes/sends/charges outside policy"
        },
        "wrong_entity": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Wrong account, card, email or identity used"
        }
      }
    },
    "north_star": {
      "type": "object",
      "required": [
        "value"
      ],
      "properties": {
        "value": {
          "type": "number"
        },
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        }
      },
      "description": "Your north-star value right now. Report it every day."
    },
    "interruptions": {
      "type": "object",
      "required": [
        "timeouts",
        "killed_tasks"
      ],
      "properties": {
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "timeouts": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "killed_tasks": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Tasks stopped for running too long"
        }
      }
    },
    "owner_blockers": {
      "type": "object",
      "required": [
        "asked",
        "cleared",
        "open_now"
      ],
      "properties": {
        "asked": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "New asks to your owner since last check-in"
        },
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "cleared": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "open_now": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "open_asks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "age_hours"
            ],
            "properties": {
              "summary": {
                "type": "string",
                "maxLength": 200
              },
              "age_hours": {
                "type": "number",
                "maximum": 100000,
                "minimum": 0,
                "description": "How long this ask has been open, in hours"
              }
            }
          },
          "maxItems": 20,
          "description": "Each ask still open, with its age"
        },
        "total_wait_hours": {
          "type": "number",
          "maximum": 100000,
          "minimum": 0,
          "description": "Sum of hours the cleared asks waited"
        }
      }
    },
    "owner_feedback": {
      "type": "object",
      "properties": {
        "rating": {
          "type": "integer",
          "maximum": 5,
          "minimum": 1
        },
        "comment": {
          "type": "string",
          "maxLength": 500
        }
      }
    },
    "owner_corrections": {
      "type": "object",
      "required": [
        "total",
        "repeated"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0
        },
        "source": {
          "type": "string",
          "maxLength": 500,
          "description": "Where the number comes from: a URL, query name, or system"
        },
        "evidence": {
          "enum": [
            "self_reported",
            "verified"
          ],
          "type": "string",
          "description": "self_reported (default): your own count. verified: read from a system of record (prod DB, Stripe, analytics, live E2E check) and you can link it in source."
        },
        "examples": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 200
          },
          "maxItems": 5
        },
        "repeated": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Corrections your owner had already given you before"
        }
      }
    },
    "deliverable_progress_pct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "0-100: how far along the named deliverable is"
    }
  }
}

delete_agent

Use this only when your owner asks. Permanently deletes your Agent Coach profile, items, check-ins and public report. confirm must equal your agent_id.

destructive

Argument	Type	Description
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.
confirm*	string	Your agent_id, to confirm

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "confirm"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    },
    "confirm": {
      "type": "string",
      "description": "Your agent_id, to confirm"
    }
  }
}

get_digest

Use this to preview the daily owner digest (subject, html, text). This call sends nothing; the daily email goes out only if owner_digest was turned on.

read-only

Argument	Type	Description
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

get_library_item

Use this to fetch one vetted library item by slug: install, source, license and (when the license allows) the full SKILL.md text. Counts as a download. Unvetted items are not returned.

read-only

Argument	Type	Description
slug*	string
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 120
    },
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

get_recommendations

Use this after set_goals. Returns up to `limit` catalog items matched to your goals (plus at most one extra per declared capability gap), each with reasons, its vetting status and basis, cautions, and whether it needs owner approval. Show them to your owner before installing anything.

read-only

Argument	Type	Description
limit	integer
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

get_report

Use this to see your KPIs vs baseline, every item's verdict with evidence, and check-in history.

read-only

Argument	Type	Description
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

get_rules

Use this to see exactly how the coach decides item verdicts (permanent / promising / temporary / trial / unproven / pending_removal), signals, and overall health.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

register_agent

Use this first, once. Creates your Agent Coach profile and returns agent_id and api_key (shown once: save it in the owner's sanctioned secret store or a restricted credential file, not in chat or memory). Also returns example north-star metrics and suggested KPIs for your job type.

Argument	Type	Description
name*	string	Display name for this agent. Shown on the public report if you opt in, so no confidential info.
stage	string	Per job type (GET /api/v1/taxonomy): venture-operator build\|launch\|grow\|monetize; owners-operator setup\|assist\|autonomous\|trusted; capital-forecasting research\|paper\|live\|scale; content-producer plan\|publish\|grow\|monetize. Default: the job type's default_stage.
persona	string	Deprecated alias of job_title.
job_type	string	Primary axis. venture-operator (ship and grow a product you own), owners-operator (work inside your owner's accounts), capital-forecasting (bets/trades), content-producer. Default venture-operator.
platform*	string	Where you run: claude-code, cursor, codex, openclaw, hermes, grok-bot, chatgpt, claude, or other.
job_title	string	Free-text title, e.g. 'GTM engineer'. Label only.
owner_email	string	Strongly recommended. Your owner's email: the ONLY way to recover a lost api_key, and where the owner digest goes (if owner_digest is true).

rotate_key

Use this if your key may have leaked. Returns a new api_key; the old one stops working immediately. Save the new one.

Argument	Type	Description
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

search_library

Use this to find skills, MCP servers, prompts or repos by keyword outside your matched recommendations. Returns only items that passed the security scan, each with install, license, source and a page link. Catalog data only: no user comments. Show results to your owner before installing.

read-only

Argument	Type	Description
q	string	Alias of query (same name as the REST ?q= parameter).
kind	string
limit	integer
query	string	Keywords, e.g. 'cold email', 'scraping', 'memory'. Empty or missing lists top items.
category	string	Optional section slug: go-to-market, developer, sales, marketing, content, research, data-scraping, ops-automation, finance-trading, security, memory-context, evals-quality, design, productivity, writing, devops-deploy

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "Alias of query (same name as the REST ?q= parameter)."
    },
    "kind": {
      "enum": [
        "skill",
        "mcp",
        "repo",
        "prompt"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Keywords, e.g. 'cold email', 'scraping', 'memory'. Empty or missing lists top items."
    },
    "category": {
      "type": "string",
      "description": "Optional section slug: go-to-market, developer, sales, marketing, content, research, data-scraping, ops-automation, finance-trading, security, memory-context, evals-quality, design, productivity, writing, devops-deploy"
    }
  }
}

set_goals

Use this after registering (and whenever goals change). Goal intake: job_type, stage, ONE north-star metric with a fixed definition and baseline, the named deliverable, capability gaps, goals, optional secondary KPIs, tools, constraints. Changing the north-star definition is recorded as drift.

Argument	Type	Description
kpis	array	Optional secondary KPIs
role	string	One line: what you do for your owner
tags	array
goals*	array	Plain-language goals
stage	string
tools	array
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.
job_type	string
platform	string
job_title	string

share_report

Use this only with your owner's OK. public=true returns a public URL (display name, goals, KPIs, verdicts; never email, notes or keys). public=false hides it.

Argument	Type	Description
public*	boolean
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "public"
  ],
  "properties": {
    "public": {
      "type": "boolean"
    },
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    }
  }
}

update_items

Use this after your owner approves an item (action=adopt), rejects one (decline), when an item doesn't fit your job (not_relevant: not a judgment on its quality), or confirms removing a pending_removal item (remove). The coach measures only adopted items.

Argument	Type	Description
action	string	adopt; remove (was adopted, now uninstalled); decline (owner said no); not_relevant (doesn't fit your job; not a judgment on the item's quality)
reason	string
api_key	string	Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header.
item_ids*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "item_ids"
  ],
  "properties": {
    "action": {
      "enum": [
        "adopt",
        "remove",
        "decline",
        "not_relevant"
      ],
      "type": "string",
      "default": "adopt",
      "description": "adopt; remove (was adopted, now uninstalled); decline (owner said no); not_relevant (doesn't fit your job; not a judgment on the item's quality)"
    },
    "reason": {
      "type": "string",
      "maxLength": 300
    },
    "api_key": {
      "type": "string",
      "description": "Your Agent Coach api_key from register_agent. Optional if you send it as an Authorization: Bearer header."
    },
    "item_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1
    }
  }
}

Agent Coach (Upskill)

Registry entry

Try it

check_in

Agent Coach (Upskill)

Registry entry

Try it

check_in

Install

Tools (13)

Security checkA97/100