@cyanheads/sanctions-screening-mcp-server 0.1.0

package/dist/mcp-server/resources/definitions/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Barrel collecting all resource definitions into
+ * `allResourceDefinitions` for `createApp()`.
+ * @module mcp-server/resources/definitions/index
+ */
+import { designationResource } from './designation.resource.js';
+import { entityResource } from './entity.resource.js';
+import { sourcesResource } from './sources.resource.js';
+export declare const allResourceDefinitions: (import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    source: import("zod").ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>;
+    entryId: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, readonly [{
+    readonly reason: "designation_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No designation exists for the given source + entry ID in the mirror.";
+    readonly recovery: "Use sanctions_screen_name to discover valid source/entryId pairs first.";
+}]> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{
+    lei: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, undefined, readonly [{
+    readonly reason: "lei_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No GLEIF entity exists for the given LEI in the mirror.";
+    readonly recovery: "Resolve the entity name with sanctions_resolve_entity to obtain a valid LEI first.";
+}]> | import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, undefined, undefined>)[];
+export { designationResource, entityResource, sourcesResource };
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;6IAAyD,CAAC;AAE7F,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/mcp-server/resources/definitions/index.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Barrel collecting all resource definitions into
+ * `allResourceDefinitions` for `createApp()`.
+ * @module mcp-server/resources/definitions/index
+ */
+import { designationResource } from './designation.resource.js';
+import { entityResource } from './entity.resource.js';
+import { sourcesResource } from './sources.resource.js';
+export const allResourceDefinitions = [designationResource, entityResource, sourcesResource];
+export { designationResource, entityResource, sourcesResource };
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,mBAAmB,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;AAE7F,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/mcp-server/resources/definitions/sources.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview `sanctions://sources` — read-only mirror of
+ * sanctions_list_sources: loaded lists + GLEIF datasets with counts and refresh
+ * timestamps. A small fixed list; no pagination.
+ * @module mcp-server/resources/definitions/sources.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const sourcesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=sources.resource.d.ts.map

package/dist/mcp-server/resources/definitions/sources.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/sources.resource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKrD,eAAO,MAAM,eAAe,2GAyC1B,CAAC"}

package/dist/mcp-server/resources/definitions/sources.resource.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview `sanctions://sources` — read-only mirror of
+ * sanctions_list_sources: loaded lists + GLEIF datasets with counts and refresh
+ * timestamps. A small fixed list; no pagination.
+ * @module mcp-server/resources/definitions/sources.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from '../../../config/server-config.js';
+import { getScreeningService } from '../../../services/screening/screening-service.js';
+import { SOURCE_LABELS } from '../../../services/screening/types.js';
+export const sourcesResource = resource('sanctions://sources', {
+    name: 'sanctions-screening-mcp-server: sources',
+    title: 'sanctions-screening-mcp-server: sources',
+    description: "List the sanctions watchlists and GLEIF datasets currently loaded in the local mirror, each with its record count and the mirror's as-of timestamp — a read-only URI mirror of sanctions_list_sources.",
+    mimeType: 'application/json',
+    params: z.object({}),
+    async handler(_params, _ctx) {
+        const svc = getScreeningService();
+        const cfg = getServerConfig();
+        const [counts, sanctions, lei] = await Promise.all([
+            svc.sourceCounts(),
+            svc.sanctionsReadiness(),
+            svc.leiReadiness(),
+        ]);
+        return {
+            sanctionsReady: sanctions.ready,
+            sanctionsAsOf: sanctions.completedAt,
+            leiReady: lei.ready,
+            leiAsOf: lei.completedAt,
+            sources: [
+                ...counts.map((s) => ({
+                    code: s.code,
+                    label: SOURCE_LABELS[s.code],
+                    recordCount: s.recordCount,
+                })),
+                {
+                    code: 'gleif',
+                    label: 'GLEIF LEI (Level 1 entities + Level 2 ownership)',
+                    recordCount: lei.entityCount,
+                    relationshipCount: lei.relationshipCount,
+                },
+            ],
+            gleifBaseUrl: cfg.gleifGoldenCopyBaseUrl,
+        };
+    },
+    list: () => ({
+        resources: [{ uri: 'sanctions://sources', name: 'Loaded sanctions sources' }],
+    }),
+});
+//# sourceMappingURL=sources.resource.js.map

package/dist/mcp-server/resources/definitions/sources.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/sources.resource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,aAAa,EAAmB,MAAM,+BAA+B,CAAC;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,qBAAqB,EAAE;IAC7D,IAAI,EAAE,yCAAyC;IAC/C,KAAK,EAAE,yCAAyC;IAChD,WAAW,EACT,wMAAwM;IAC1M,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI;QACzB,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACjD,GAAG,CAAC,YAAY,EAAE;YAClB,GAAG,CAAC,kBAAkB,EAAE;YACxB,GAAG,CAAC,YAAY,EAAE;SACnB,CAAC,CAAC;QACH,OAAO;YACL,cAAc,EAAE,SAAS,CAAC,KAAK;YAC/B,aAAa,EAAE,SAAS,CAAC,WAAW;YACpC,QAAQ,EAAE,GAAG,CAAC,KAAK;YACnB,OAAO,EAAE,GAAG,CAAC,WAAW;YACxB,OAAO,EAAE;gBACP,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,IAAkB,CAAC;oBAC1C,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH;oBACE,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,kDAAkD;oBACzD,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;iBACzC;aACF;YACD,YAAY,EAAE,GAAG,CAAC,sBAAsB;SACzC,CAAC;IACJ,CAAC;IAED,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACX,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;KAC9E,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/_shared.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Shared constants for the sanctions screening tool surface. The
+ * decision-support caveat is load-bearing — it appears in every screening tool's
+ * output so a consuming model cannot present a fuzzy hit as a verdict.
+ * @module mcp-server/tools/definitions/_shared
+ */
+/**
+ * The decision-support caveat carried in every screening tool's output. States
+ * the three load-bearing facts: results are potential matches to verify, a hit
+ * is not a finding of fact, and an empty result is not a clearance.
+ */
+export declare const SCREENING_CAVEAT = "Screening aid, not a compliance determination. Results are potential matches to verify against the official source \u2014 a hit is not a finding of fact, and an empty result is not a clearance. Real sanctions compliance is a legal process this server feeds, not one it performs.";
+//# sourceMappingURL=_shared.d.ts.map

package/dist/mcp-server/tools/definitions/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2RACwP,CAAC"}

package/dist/mcp-server/tools/definitions/_shared.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Shared constants for the sanctions screening tool surface. The
+ * decision-support caveat is load-bearing — it appears in every screening tool's
+ * output so a consuming model cannot present a fuzzy hit as a verdict.
+ * @module mcp-server/tools/definitions/_shared
+ */
+/**
+ * The decision-support caveat carried in every screening tool's output. States
+ * the three load-bearing facts: results are potential matches to verify, a hit
+ * is not a finding of fact, and an empty result is not a clearance.
+ */
+export const SCREENING_CAVEAT = 'Screening aid, not a compliance determination. Results are potential matches to verify against the official source — a hit is not a finding of fact, and an empty result is not a clearance. Real sanctions compliance is a legal process this server feeds, not one it performs.';
+//# sourceMappingURL=_shared.js.map

package/dist/mcp-server/tools/definitions/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,mRAAmR,CAAC"}

package/dist/mcp-server/tools/definitions/get-designation.tool.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview `sanctions_get_designation` — the full record for one sanctions
+ * entry by source list + entry ID. The drill-in after sanctions_screen_name
+ * surfaces a candidate: all aliases, identifiers, addresses, dates/places of
+ * birth, nationalities, program, legal basis, and designation date. Still a
+ * screening aid — the record is what the source published, not a determination.
+ * @module mcp-server/tools/definitions/get-designation.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getDesignationTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    source: z.ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>;
+    entryId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    source: z.ZodEnum<{
+        ofac_sdn: "ofac_sdn";
+        ofac_consolidated: "ofac_consolidated";
+        eu: "eu";
+        uk: "uk";
+        un: "un";
+    }>;
+    sourceLabel: z.ZodString;
+    sourceEntryId: z.ZodString;
+    entityType: z.ZodEnum<{
+        unknown: "unknown";
+        person: "person";
+        organization: "organization";
+        vessel: "vessel";
+        aircraft: "aircraft";
+    }>;
+    primaryName: z.ZodString;
+    program: z.ZodOptional<z.ZodString>;
+    legalBasis: z.ZodOptional<z.ZodString>;
+    designationDate: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        nameType: z.ZodEnum<{
+            primary: "primary";
+            aka: "aka";
+            fka: "fka";
+            "low-quality-aka": "low-quality-aka";
+        }>;
+    }, z.core.$strip>>;
+    identifiers: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodString;
+        country: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    addresses: z.ZodArray<z.ZodObject<{
+        full: z.ZodString;
+        country: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    datesOfBirth: z.ZodArray<z.ZodObject<{
+        date: z.ZodOptional<z.ZodString>;
+        place: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    nationalities: z.ZodArray<z.ZodString>;
+    remarks: z.ZodOptional<z.ZodString>;
+    caveat: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "designation_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No designation exists for the given source + entry ID in the mirror.";
+    readonly recovery: "Verify the source and entryId via sanctions_screen_name, which returns the exact sourceEntryId for each hit.";
+}, {
+    readonly reason: "mirror_not_ready";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The sanctions mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the sanctions lists, then retry.";
+}], undefined>;
+//# sourceMappingURL=get-designation.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-designation.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-designation.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-designation.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwK7B,CAAC"}

package/dist/mcp-server/tools/definitions/get-designation.tool.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview `sanctions_get_designation` — the full record for one sanctions
+ * entry by source list + entry ID. The drill-in after sanctions_screen_name
+ * surfaces a candidate: all aliases, identifiers, addresses, dates/places of
+ * birth, nationalities, program, legal basis, and designation date. Still a
+ * screening aid — the record is what the source published, not a determination.
+ * @module mcp-server/tools/definitions/get-designation.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getScreeningService } from '../../../services/screening/screening-service.js';
+import { SOURCE_LABELS } from '../../../services/screening/types.js';
+import { SCREENING_CAVEAT } from './_shared.js';
+export const getDesignationTool = tool('sanctions_get_designation', {
+    title: 'sanctions-screening-mcp-server: get designation',
+    description: 'Fetch the full record for one sanctions designation by source list + entry ID — the drill-in after sanctions_screen_name surfaces a candidate. Returns all published aliases, identifiers (passport/national-ID/tax), addresses, dates and places of birth, nationalities, sanctioning program, legal basis, and designation date. The record reflects exactly what the source published; missing fields mean the source omitted them. This is a screening aid — the designation record supports a compliance review, it is not itself a determination.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        source: z
+            .enum(['ofac_sdn', 'ofac_consolidated', 'eu', 'uk', 'un'])
+            .describe('Which source list the entry belongs to.'),
+        entryId: z
+            .string()
+            .min(1)
+            .describe("The source list's own entry ID (the sourceEntryId from sanctions_screen_name)."),
+    }),
+    output: z.object({
+        source: z
+            .enum(['ofac_sdn', 'ofac_consolidated', 'eu', 'uk', 'un'])
+            .describe('Source list the entry belongs to.'),
+        sourceLabel: z.string().describe('Human-readable name of the source list.'),
+        sourceEntryId: z.string().describe("The source list's own entry ID."),
+        entityType: z
+            .enum(['person', 'organization', 'vessel', 'aircraft', 'unknown'])
+            .describe('Entity classification as published.'),
+        primaryName: z.string().describe('Primary published name.'),
+        program: z.string().optional().describe('Sanctioning program / regime, when published.'),
+        legalBasis: z.string().optional().describe('Statutory / regulatory basis, when published.'),
+        designationDate: z.string().optional().describe('Designation date, when published.'),
+        aliases: z
+            .array(z
+            .object({
+            name: z.string().describe('Alias as published.'),
+            nameType: z
+                .enum(['primary', 'aka', 'fka', 'low-quality-aka'])
+                .describe('Alias provenance: a.k.a., f.k.a., or a low-quality a.k.a.'),
+        })
+            .describe('One published alias.'))
+            .describe('All published aliases / name variants.'),
+        identifiers: z
+            .array(z
+            .object({
+            type: z.string().describe('Identifier category (e.g. Passport, National ID, Tax ID).'),
+            value: z.string().describe('Identifier value as published.'),
+            country: z.string().optional().describe('Issuing country/authority, when published.'),
+        })
+            .describe('One structured identifier.'))
+            .describe('Published identifiers (passport, national ID, tax, registration, …).'),
+        addresses: z
+            .array(z
+            .object({
+            full: z.string().describe('Single-line rendering of the address.'),
+            country: z.string().optional().describe('Country, when published.'),
+        })
+            .describe('One published address.'))
+            .describe('Published addresses.'),
+        datesOfBirth: z
+            .array(z
+            .object({
+            date: z.string().optional().describe('Date of birth as published.'),
+            place: z.string().optional().describe('Place of birth, when published.'),
+        })
+            .describe('One date/place of birth.'))
+            .describe('Published dates and places of birth (persons).'),
+        nationalities: z.array(z.string()).describe('Published nationalities / citizenships.'),
+        remarks: z
+            .string()
+            .optional()
+            .describe('Free-form remarks published by the source, when present.'),
+        caveat: z
+            .string()
+            .describe('Decision-support caveat — this is a screening aid, not a compliance determination.'),
+    }),
+    errors: [
+        {
+            reason: 'designation_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No designation exists for the given source + entry ID in the mirror.',
+            recovery: 'Verify the source and entryId via sanctions_screen_name, which returns the exact sourceEntryId for each hit.',
+        },
+        {
+            reason: 'mirror_not_ready',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The sanctions mirror has never completed an initial sync.',
+            retryable: true,
+            recovery: 'Run the mirror:init lifecycle script to load the sanctions lists, then retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getScreeningService();
+        if (!(await svc.sanctionsReady())) {
+            throw ctx.fail('mirror_not_ready', 'The local sanctions mirror is not yet populated.', {
+                ...ctx.recoveryFor('mirror_not_ready'),
+            });
+        }
+        const d = await svc.getDesignation(input.source, input.entryId);
+        if (!d) {
+            throw ctx.fail('designation_not_found', `No ${input.source} designation with entry ID "${input.entryId}".`, { ...ctx.recoveryFor('designation_not_found') });
+        }
+        return {
+            source: d.source,
+            sourceLabel: SOURCE_LABELS[d.source],
+            sourceEntryId: d.sourceEntryId,
+            entityType: d.entityType,
+            primaryName: d.primaryName,
+            ...(d.program ? { program: d.program } : {}),
+            ...(d.legalBasis ? { legalBasis: d.legalBasis } : {}),
+            ...(d.designationDate ? { designationDate: d.designationDate } : {}),
+            aliases: d.payload.aliases,
+            identifiers: d.payload.identifiers,
+            addresses: d.payload.addresses,
+            datesOfBirth: d.payload.datesOfBirth,
+            nationalities: d.payload.nationalities,
+            ...(d.payload.remarks ? { remarks: d.payload.remarks } : {}),
+            caveat: SCREENING_CAVEAT,
+        };
+    },
+    format: (r) => {
+        const lines = [`# ${r.primaryName}`, ''];
+        lines.push(`**List:** ${r.sourceLabel} (\`${r.source}\`) | **Entry ID:** ${r.sourceEntryId}`);
+        lines.push(`**Type:** ${r.entityType}`);
+        if (r.program)
+            lines.push(`**Program:** ${r.program}`);
+        if (r.legalBasis)
+            lines.push(`**Legal basis:** ${r.legalBasis}`);
+        if (r.designationDate)
+            lines.push(`**Designated:** ${r.designationDate}`);
+        if (r.aliases.length > 0) {
+            lines.push('\n## Aliases');
+            for (const a of r.aliases)
+                lines.push(`- ${a.name} (${a.nameType})`);
+        }
+        if (r.identifiers.length > 0) {
+            lines.push('\n## Identifiers');
+            for (const i of r.identifiers) {
+                lines.push(`- **${i.type}:** ${i.value}${i.country ? ` (${i.country})` : ''}`);
+            }
+        }
+        if (r.addresses.length > 0) {
+            lines.push('\n## Addresses');
+            for (const a of r.addresses)
+                lines.push(`- ${a.full}${a.country ? ` — ${a.country}` : ''}`);
+        }
+        if (r.datesOfBirth.length > 0) {
+            lines.push('\n## Dates of birth');
+            for (const d of r.datesOfBirth) {
+                lines.push(`- ${d.date ?? 'Unknown date'}${d.place ? ` at ${d.place}` : ''}`);
+            }
+        }
+        if (r.nationalities.length > 0)
+            lines.push(`\n**Nationalities:** ${r.nationalities.join(', ')}`);
+        if (r.remarks)
+            lines.push(`\n**Remarks:** ${r.remarks}`);
+        lines.push(`\n> ${r.caveat}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-designation.tool.js.map

package/dist/mcp-server/tools/definitions/get-designation.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-designation.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-designation.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview `sanctions_get_entity` — the full GLEIF Level 1 record for one
+ * LEI, plus any sanctions hits screened against the same legal name. Combines
+ * the who-is-who reference data with a cross-reference screen so an agent sees
+ * both "who is this entity" and "is its name on a watchlist" in one call.
+ * @module mcp-server/tools/definitions/get-entity.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getEntityTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    lei: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    lei: z.ZodString;
+    legalName: z.ZodString;
+    otherNames: z.ZodArray<z.ZodString>;
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    legalAddress: z.ZodOptional<z.ZodString>;
+    headquartersAddress: z.ZodOptional<z.ZodString>;
+    registrationAuthorityId: z.ZodOptional<z.ZodString>;
+    registrationAuthorityEntityId: z.ZodOptional<z.ZodString>;
+    lastUpdate: z.ZodOptional<z.ZodString>;
+    sanctionsHits: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<{
+            ofac_sdn: "ofac_sdn";
+            ofac_consolidated: "ofac_consolidated";
+            eu: "eu";
+            uk: "uk";
+            un: "un";
+        }>;
+        sourceLabel: z.ZodString;
+        sourceEntryId: z.ZodString;
+        primaryName: z.ZodString;
+        matchedName: z.ZodString;
+        matchType: z.ZodEnum<{
+            exact: "exact";
+            strong: "strong";
+            approximate: "approximate";
+        }>;
+        score: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    caveat: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "lei_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No GLEIF entity exists for the given LEI in the mirror.";
+    readonly recovery: "Resolve the entity name with sanctions_resolve_entity to obtain a valid LEI first.";
+}, {
+    readonly reason: "mirror_not_ready";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The GLEIF (LEI) mirror has never completed an initial sync.";
+    readonly retryable: true;
+    readonly recovery: "Run the mirror:init lifecycle script to load the GLEIF golden copy, then retry.";
+}], undefined>;
+//# sourceMappingURL=get-entity.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-entity.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkLxB,CAAC"}