# KYB due diligence

Checks who owns and runs a company, screens it against the sanctions lists and gives a cited verdict.

Requires web search, through Exa. Requires web fetch.

## Install

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun/packages/serve/templates/kyb@860cae180df56af4d9a206ef2c997178da29fcf9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun%2Fpackages%2Fserve%2Ftemplates%2Fkyb%40860cae180df56af4d9a206ef2c997178da29fcf9`. Pinned to commit 860cae180df56af4d9a206ef2c997178da29fcf9.

## What it does

Business due diligence (KYB) on one company. Establishes who it is from primary registries, who owns and runs it, screens the company and each named person against the OFAC, UN, EU and UK sanctions lists themselves, finds dated adverse media, grades red flags by your risk appetite and gives a verdict. Every claim is cited, and nothing is invented.

- Skill `kyb`: Business due diligence (KYB) on one company. Resolve the right legal entity, establish its identity from primary registries, its owners and controllers, screen it and each named person against the OFAC, UN, EU and UK sanctions lists themselves, find dated adverse media, grade red flags by the risk appetite, give a verdict, and answer as JSON with a short narrative. Use for "run KYB on", "due diligence on this company", "check this vendor/customer", /kyb.
- Rules: `ADVERSE-MEDIA.md`, `RED-FLAGS.md`, `SANCTIONS.md`, `SOURCES.md`

## What starts it

- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `company` | string, 1 to 200 characters | yes | The company's legal or trading name, as the applicant gave it. Example: `Stripe, Inc.`. |
| `website` | string, 0 to 300 characters | no | Optional. The company's website or domain (stripe.com or https://stripe.com). Example: `stripe.com`. |
| `country` | string | no | Optional. ISO 3166-1 alpha-2 code, in capitals (US, GB, CA). Example: `US`. |
| `registration_number` | string, 0 to 100 characters | no | Optional. The company number in its registry, as the applicant gave it. |
| `reason` | string, one of vendor, customer, investment | no | Optional. vendor, customer or investment. Left out: unspecified. |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `risk_appetite` | string, one of low, medium, high | no | Low, medium or high: how much risk you accept, which sets how each red flag is graded and which verdict it leads to. Use medium (the default) unless your policy says otherwise; low is for regulated onboarding, high for low-exposure vendors. Default: `medium`. |
| `jurisdictions_of_interest` | string | no | Optional. Countries that matter to you, as ISO 3166-1 alpha-2 codes separated by commas (e.g. US,GB,AE). Every tie the company has to one (incorporation, address, owner, officer, operations) is reported. Empty: none. |
| `opensanctions` | boolean | no | Optional. Also look each name up in OpenSanctions (opensanctions.org), one index of every sanctions list, beside the list owners' own sites. Licence: OpenSanctions data is CC BY-NC 4.0, free for non-commercial use only; commercial use needs a paid licence from OpenSanctions. Turn it on only if your use is non-commercial or you hold that licence. Off (the default): the list owners' own sites only. Default: `false`. |

## What it needs

- Harness: pi
- Model: balanced tier, medium effort
- Tools: read, web_search, web_fetch, ask_person
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

No sample output ships with this template yet.

## Tested

8 eval cases: adverse-media, canada-active-filed, clean-public-company, injection-in-page, name-collision, no-invention, opensanctions-on, sanctioned-entity.

## Source

- Package: https://github.com/Parcha-ai/agentrun/tree/860cae180df56af4d9a206ef2c997178da29fcf9/packages/serve/templates/kyb
- Publisher: Parcha-ai (1210 stars, 95 forks)
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Compliance
- Page: https://marketplace.agentrun.ai/templates/kyb/
