ACI Risk Indicators

1---
2name: aci-risk-indicators
3description: Use when the user asks about Aethon Credit Intelligence (ACI) Risk Indicators for digital asset yield providers and products — which modules exist, which providers sit in a module or risk band, one provider's indicator or breakdown, a side-by-side comparison, a portfolio composite, or a summary of these outputs for a committee. Reports only the fields the ACI connector returns.
4---
5 
6# ACI Risk Indicators
7 
8## What ACI is
9 
10> ACI Risk Indicators are model-derived quantitative analytics outputs produced under the ACI Framework v1.0 using defined inputs and publicly available data. Outputs are designed to support independent analysis within professional and institutional decision-making processes.
11 
12Every tool result carries this classification anchor in `classification_anchor`:
13 
14> ACI Framework v1.0 · aethoncredit.com · Quantitative risk analytics outputs for independent analysis
15 
16## The tools
17 
18The ACI connector (`https://mcp.aethoncredit.com/mcp`) has six read-only tools.
19 
20| Tool | Inputs | What `data` holds |
21|---|---|---|
22| `list_modules` | none | per module: `code`, `name`, `description`, `provider_count`, `criteria_count` |
23| `search_providers` | `query`, `module`, `risk_band`, `subtype`, `limit` (1–100, default 25) | per provider: `name`, `module`, `risk_band`; where the plan includes values, also `slug`, `score` and `subtype` |
24| `get_risk_score` | `provider_slug` or `provider_name` | `provider_name`, `module`, `score`, `risk_band`, `hard_caps_applied`, `confidence_level`, `last_certified`, `methodology_version` |
25| `get_provider_detail` | `provider_slug` | `provider_name`, `slug`, `module`, `subtype`, `score`, `risk_band`, `criterion_scores` (per criterion: `label`, `score`, `weight`, `weighted_contribution`, `confidence`, `worst_case_applied`, `applicability`, `bucket`), `hard_caps_applied`, `stress_classification`, `last_certified`, `evidence_summary` |
26| `compare_providers` | `slugs` (2–5) | `providers` (each as in `get_provider_detail`) and `comparison_matrix` (`criteria`, `score`, `risk_band`) |
27| `assess_portfolio_risk` | `allocations`: 2–20 positions of `provider_slug` and `weight`, each weight 0.01–1.0, summing to 1.0 ± 0.01 | `composite_score`, `risk_band`, `per_provider_scores`, `counterparty_concentration_pct`, `custody_concentration_pct`, `regulatory_mix_warning`, `elevated_warnings`, `stress_classification`, `notes` |
28 
29Every result also carries `disclosure`, `classification_anchor` and `methodology_url`. A result with an indicator value, a band or a breakdown adds `scope_note`. In the text, `score` is the indicator value: call it the ACI Risk Indicator, or the indicator value.
30 
31## Who sees what
32 
33The connector checks the user's plan on every call.
34 
35- No sign-in: list_modules, search_providers. The Professional plan adds get_risk_score, get_provider_detail, compare_providers, assess_portfolio_risk.
36- Below the Professional plan, search_providers results show name, module and risk band only.
37- Accounts on the Sandbox and Analyst plans see what a signed-out caller sees.
38- A tool above the user's plan returns a refusal that names the plan it needs. When the user is not signed in, calling that tool starts the sign-in to their Aethon Credit Intelligence account.
39 
40## Workflows
41 
42Use a workflow only where the user's plan includes its tool.
43 
44### 1. First connection
45 
46When the user starts, tell them what they can see at their plan, from **Who sees what**. Signed out, that is the list of modules and a search with the risk band of each provider. Do not ask them to sign in up front: calling a tool that needs an account starts the sign-in when they ask for something it returns.
47 
48### 2. One provider
49 
50- Professional and above: call `get_risk_score` with the slug or the name. If nothing is found, call `search_providers` with the name as `query` and show the matches.
51- Below Professional: call `search_providers` with the name as `query`, and give `name`, `module` and `risk_band` only.
52- For the breakdown (Professional and above): call `get_provider_detail`.
53 
54### 3. Screening within a module
55 
56Call `list_modules` for the module codes, then `search_providers` with `module`, and `risk_band` if the user names one. Show the rows as returned, in the order returned.
57 
58### 4. Side-by-side comparison (Professional and above)
59 
60Call `compare_providers` with 2–5 slugs and lay out `comparison_matrix` as a table: one column per provider, one row per criterion, then the indicator value and the band. Name no provider as stronger, weaker or preferred, and order the columns as the user listed the providers.
61 
62### 5. Summary for committee review
63 
64A structured summary of what the tools returned, and nothing else:
65 
661. Provider, module, and the indicator value with its band (or the band only, if that is all the result shows).
672. Hard caps, as listed in `hard_caps_applied`.
683. `confidence_level`, `last_certified` and `methodology_version`, as returned.
694. For a breakdown: each criterion's label, value, weight and weighted contribution.
705. The `scope_note`, verbatim.
716. The classification anchor, as the last line.
72 
73The summary describes outputs. It proposes no decision, allocation or action.
74 
75No tool returns history, changes over time or a stress interpretation, so this skill offers none. `stress_classification` is reported as returned, without comment.
76 
77## Rules
78 
79- Report only the fields in `data`. The `scope_note` says ACI returned no reasons, drivers or explanations; supply none of your own.
80- Weighted contributions are rounded per criterion, so they need not add up to the indicator value. Do not explain the difference.
81- If a result shows the band only, give the band only. Never estimate or infer a value.
82- Never propose an allocation, a transaction or any other action, and never describe one provider as better or worse than another.
83- Report `last_certified` as returned. If it is null, say that no certification is recorded for the indicator.
84- A portfolio composite is not an ACI Risk Indicator. When you show one, quote:
85 
86  > This portfolio assessment is a computed analytical output based on individual provider Risk Indicators. It is not a certified ACI Risk Indicator.
87 
88- If `risk_band` is null, report no band. Never assign one.
89- Report a refusal as returned. If it names a plan, point the user to aethoncredit.com/pricing.
90- Keep to the vocabulary in `references/language.md`.
91- End every answer that shows ACI output with the classification anchor.
92 
93## Examples
94 
95Values are shown as `{{tokens}}`: the tools supply them.
96 
97**"Which ACI modules are there?"** → `list_modules`
98 
99```json
100{
101  "data": [
102    { "code": "{{module_code}}", "name": "{{module_name}}", "description": "{{module_description}}", "provider_count": "{{provider_count}}", "criteria_count": "{{criteria_count}}" }
103  ],
104  "disclosure": "ACI Risk Indicators: quantitative analytics only. Not investment advice. Not a credit rating.",
105  "classification_anchor": "ACI Framework v1.0 · aethoncredit.com · Quantitative risk analytics outputs for independent analysis",
106  "methodology_url": "https://aethoncredit.com/methodology"
107}
108```
109 
110**"Which stablecoin yield providers have a MEDIUM band?"** → `search_providers` with `module: "stablecoin"`, `risk_band: "MEDIUM"`. Below Professional:
111 
112```json
113{
114  "data": [
115    { "name": "{{provider_name}}", "module": "stablecoin", "risk_band": "MEDIUM" }
116  ],
117  "disclosure": "ACI Risk Indicators: quantitative analytics only. Not investment advice. Not a credit rating.",
118  "classification_anchor": "ACI Framework v1.0 · aethoncredit.com · Quantitative risk analytics outputs for independent analysis",
119  "methodology_url": "https://aethoncredit.com/methodology"
120}
121```
122 
123On Professional and above, each row adds `slug`, `score` and `subtype`.
124 
125**"What is the ACI Risk Indicator for {{provider_name}}?"** → `get_risk_score` (Professional and above)
126 
127```json
128{
129  "data": {
130    "provider_name": "{{provider_name}}",
131    "module": "{{module_code}}",
132    "score": "{{indicator_value}}",
133    "risk_band": "{{risk_band}}",
134    "hard_caps_applied": [],
135    "confidence_level": "{{confidence_level}}",
136    "last_certified": "{{last_certified}}",
137    "methodology_version": "{{methodology_version}}"
138  },
139  "scope_note": "This response contains only the fields in data. ACI returned no reasons, drivers or explanations for any score, band or criterion beyond those fields.",
140  "disclosure": "ACI Risk Indicators: quantitative analytics only. Not investment advice. Not a credit rating.",
141  "classification_anchor": "ACI Framework v1.0 · aethoncredit.com · Quantitative risk analytics outputs for independent analysis",
142  "methodology_url": "https://aethoncredit.com/methodology"
143}
144```
145 
146**"Compare {{provider_a}} and {{provider_b}}."** → `compare_providers` (Professional and above). `data` holds `providers` and `comparison_matrix`:
147 
148```json
149{
150  "comparison_matrix": {
151    "criteria": { "{{criterion_key}}": { "{{slug_a}}": { "label": "{{criterion_label}}", "score": "{{criterion_value}}", "weight": "{{criterion_weight}}", "weighted_contribution": "{{weighted_contribution}}" } } },
152    "score": { "{{slug_a}}": "{{indicator_value_a}}", "{{slug_b}}": "{{indicator_value_b}}" },
153    "risk_band": { "{{slug_a}}": "{{risk_band_a}}", "{{slug_b}}": "{{risk_band_b}}" }
154  }
155}
156```
157 
158**"Assess an allocation: {{weight_a}} in {{provider_a}}, {{weight_b}} in {{provider_b}}."** → `assess_portfolio_risk` (Professional and above). `data` holds `composite_score`, `risk_band`, `per_provider_scores` (each: `provider_slug`, `provider_name`, `module`, `score`, `risk_band`, `weight`, `weighted_contribution`, `status`) and the portfolio fields in the tools table. Quote the composite note above when you show it.
159 
160**A tool above the user's plan**, e.g. `get_risk_score` on the Sandbox plan:
161 
162```text
163FORBIDDEN: 'get_risk_score' is available on the Professional plan and above (current plan: Sandbox). See aethoncredit.com/pricing.
164ACI Framework v1.0 · aethoncredit.com · Quantitative risk analytics outputs for independent analysis
165```
166 
167## References
168 
169- `references/bands.md`: the four risk bands.
170- `references/modules.md`: the module codes and names.
171- `references/methodology.md`: what the methodology fields mean, and where the methodology is published.
172- `references/language.md`: the vocabulary to use and to avoid.
173