identity.preferences
V1.1 · post-MVPRead preference inspection surface. (Preview — V1.1+.)
Description
Per ADR-0021 §read-API Family E. Stub-ships at MVP.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
scope | string | no | Optional scope filter. |
Output shape
typescript
{ ok: false; error: "feature_not_available"; details: { adr: "ADR-0021"; section: "Family E — Identity / Availability"; shipping: "V1.1+" } }Example call
JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):
jsontools/call params
{ "name": "identity.preferences", "arguments": {} }Example response
Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):
jsonparsed result body
{ "ok": false, "error": "feature_not_available", "details": { "adr": "ADR-0021", "section": "Family E — Identity / Availability", "shipping": "V1.1+" } }Errors this tool can return
| Code | Meaning |
|---|---|
unauthorized | Missing or invalid bearer token. |
feature_not_available | The tool is registered but the underlying capability is not wired in this build. |
See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).