@odatano/core-mcp 0.1.0

package/dist/config.js

@@ -0,0 +1,40 @@
+/** ODATANO service names (path segments after the prefix). */
+export const SERVICES = {
+    odata: 'cardano-odata',
+    transaction: 'cardano-transaction',
+    sign: 'cardano-sign',
+    worker: 'cardano-worker',
+    indexer: 'cardano-indexer',
+};
+function positiveInt(name, raw, fallback) {
+    if (raw === undefined || raw === '')
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 0 || !Number.isInteger(n)) {
+        throw new Error(`Invalid ${name}: ${raw}`);
+    }
+    return n;
+}
+function bool(raw) {
+    if (raw === undefined)
+        return false;
+    return ['1', 'true', 'yes', 'on'].includes(raw.trim().toLowerCase());
+}
+export function loadConfig(env = process.env) {
+    const baseUrl = (env.ODATANO_BASE_URL ?? 'http://localhost:4004').replace(/\/+$/, '');
+    let servicePrefix = env.ODATANO_SERVICE_PREFIX ?? '/odata/v4';
+    if (!servicePrefix.startsWith('/'))
+        servicePrefix = `/${servicePrefix}`;
+    servicePrefix = servicePrefix.replace(/\/+$/, '');
+    return {
+        baseUrl,
+        token: env.ODATANO_TOKEN || undefined,
+        username: env.ODATANO_USERNAME || undefined,
+        password: env.ODATANO_PASSWORD || undefined,
+        servicePrefix,
+        timeoutMs: positiveInt('ODATANO_TIMEOUT_MS', env.ODATANO_TIMEOUT_MS, 30000),
+        maxRows: positiveInt('ODATANO_MCP_MAX_ROWS', env.ODATANO_MCP_MAX_ROWS, 50),
+        enableWalletJobs: bool(env.ODATANO_MCP_ENABLE_WALLET_JOBS),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA2BA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,qBAAqB;IAClC,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,iBAAiB;CAClB,CAAC;AAIX,SAAS,WAAW,CAAC,IAAY,EAAE,GAAuB,EAAE,QAAgB;IAC1E,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,IAAI,CAAC,GAAuB;IACnC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtF,IAAI,aAAa,GAAG,GAAG,CAAC,sBAAsB,IAAI,WAAW,CAAC;IAC9D,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACxE,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,OAAO;QACP,KAAK,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;QACrC,QAAQ,EAAE,GAAG,CAAC,gBAAgB,IAAI,SAAS;QAC3C,QAAQ,EAAE,GAAG,CAAC,gBAAgB,IAAI,SAAS;QAC3C,aAAa;QACb,SAAS,EAAE,WAAW,CAAC,oBAAoB,EAAE,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC;QAC3E,OAAO,EAAE,WAAW,CAAC,sBAAsB,EAAE,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC1E,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { OdatanoClient } from './client.js';
+import { loadConfig } from './config.js';
+import { buildServer, detectCapabilities } from './server.js';
+async function main() {
+    const config = loadConfig();
+    const client = new OdatanoClient(config);
+    const caps = await detectCapabilities(client);
+    const server = buildServer(config, caps);
+    // stdio transport: stdout is the protocol channel, diagnostics go to stderr
+    const optional = [caps.worker && 'worker', caps.indexer && 'indexer'].filter(Boolean).join(', ') || 'none (core < 2.0 or unreachable)';
+    console.error(`odatano-mcp: connecting tools to ${config.baseUrl}${config.servicePrefix} (v2.0 services: ${optional}` +
+        `${caps.worker && config.enableWalletJobs ? '; wallet jobs ENABLED' : ''})`);
+    await server.connect(new StdioServerTransport());
+}
+main().catch((err) => {
+    console.error('odatano-mcp failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE9D,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kCAAkC,CAAC;IACvI,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,oBAAoB,QAAQ,EAAE;QACnH,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Output hygiene for tool results: cap long arrays and elide huge CBOR/hex
+ * blobs nested inside results so a single tool call cannot flood the agent's
+ * context. The tools whose purpose IS returning CBOR (build_*, get_build_details,
+ * parse_transaction_cbor) call {@link trimResult} with `keepCbor: true`.
+ */
+export interface TrimOptions {
+    /** Max elements kept in any array (top-level `value` and nested). */
+    maxRows: number;
+    /** Keep CBOR/script hex fields verbatim (default: elide above `cborLimit`). */
+    keepCbor?: boolean;
+    /** Character limit above which CBOR-ish string fields are elided. */
+    cborLimit?: number;
+}
+export declare function trimResult(payload: unknown, opts: TrimOptions): unknown;
+/**
+ * Convert a 404 from a Get* read into the "clean negative" shape used across
+ * ODATANO/NIGHTGATE MCP servers: `{ found: false, ... }` instead of an error.
+ */
+export declare function notFound(detail: Record<string, unknown>): Record<string, unknown>;

package/dist/output.js

@@ -0,0 +1,45 @@
+/**
+ * Output hygiene for tool results: cap long arrays and elide huge CBOR/hex
+ * blobs nested inside results so a single tool call cannot flood the agent's
+ * context. The tools whose purpose IS returning CBOR (build_*, get_build_details,
+ * parse_transaction_cbor) call {@link trimResult} with `keepCbor: true`.
+ */
+const CBOR_KEYS = new Set([
+    'unsignedTxCbor', 'signedTxCbor', 'txCbor', 'cbor', 'rawCbor',
+    'validatorScript', 'mintingPolicyScript', 'referenceScriptHex', 'scriptCbor',
+]);
+export function trimResult(payload, opts) {
+    const cborLimit = opts.cborLimit ?? 8192;
+    return walk(payload, 0);
+    function walk(value, depth) {
+        if (Array.isArray(value)) {
+            const kept = value.slice(0, opts.maxRows).map((v) => walk(v, depth + 1));
+            if (value.length > opts.maxRows) {
+                // Arrays cannot carry a marker without changing element types, so
+                // the truncation notice is appended as a final string element.
+                kept.push(`… ${value.length - opts.maxRows} more item(s) truncated (limit ${opts.maxRows}); narrow with $filter/$top or increase ODATANO_MCP_MAX_ROWS`);
+            }
+            return kept;
+        }
+        if (value !== null && typeof value === 'object') {
+            const out = {};
+            for (const [k, v] of Object.entries(value)) {
+                if (!opts.keepCbor && typeof v === 'string' && CBOR_KEYS.has(k) && v.length > cborLimit) {
+                    out[k] = `<${k}: ${v.length} hex chars elided — use get_build_details / get_signing_request to fetch it>`;
+                    continue;
+                }
+                out[k] = walk(v, depth + 1);
+            }
+            return out;
+        }
+        return value;
+    }
+}
+/**
+ * Convert a 404 from a Get* read into the "clean negative" shape used across
+ * ODATANO/NIGHTGATE MCP servers: `{ found: false, ... }` instead of an error.
+ */
+export function notFound(detail) {
+    return { found: false, ...detail };
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS;IAC7D,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,YAAY;CAC7E,CAAC,CAAC;AAWH,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,IAAiB;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAExB,SAAS,IAAI,CAAC,KAAc,EAAE,KAAa;QACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAChC,kEAAkE;gBAClE,+DAA+D;gBAC/D,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,kCAAkC,IAAI,CAAC,OAAO,8DAA8D,CAAC,CAAC;YAC1J,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;oBACxF,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,8EAA8E,CAAC;oBAC1G,SAAS;gBACX,CAAC;gBACD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAA+B;IACtD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;AACrC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const hex64: (what: string) => z.ZodString;
+export declare const hex56: (what: string) => z.ZodString;
+/** Any even-length hex string (CBOR, COSE, scripts). */
+export declare const hexString: (what: string, max?: number) => z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Bech32 Cardano address (payment or stake). Loose check: prefix + charset +
+ * length; the server does the checksum. Accepts addr / addr_test / stake /
+ * stake_test.
+ */
+export declare const bech32Address: z.ZodString;
+export declare const stakeAddress: z.ZodString;
+export declare const poolId: z.ZodString;
+export declare const drepId: z.ZodString;
+/** `policyId (56 hex) + assetNameHex (0..64 hex)`; `lovelace` is also accepted where the server does. */
+export declare const assetUnit: z.ZodString;
+/**
+ * Non-negative integer amount as decimal string (preferred, exact) or JS
+ * number. Always forwarded to ODATANO as a string so nothing is rounded.
+ */
+export declare const amount: (what: string) => z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, string, string | number>;
+/** Positive integer amount (>= 1). */
+export declare const positiveAmount: (what: string) => z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, string, string | number>;
+/** Posix milliseconds as decimal string or number, forwarded as string. */
+export declare const posixMs: (what: string) => z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, string, string | number>;
+/** A string that must parse as JSON (objects/arrays are passed pre-stringified to ODATANO). */
+export declare const jsonString: (what: string, kind?: "array" | "object" | "any") => z.ZodEffects<z.ZodString, string, string>;
+/**
+ * JSON that the agent may pass either as a string or as a native value; the
+ * native form is stringified before it reaches ODATANO. Convenient for
+ * datums / redeemers / metadata objects.
+ */
+export declare const jsonValue: (what: string, kind?: "array" | "object" | "any") => z.ZodEffects<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodUnknown | z.ZodArray<z.ZodUnknown, "many"> | z.ZodRecord<z.ZodString, z.ZodUnknown>]>, string, unknown>;
+export declare const uuid: (what: string) => z.ZodString;
+export declare const network: z.ZodEnum<["mainnet", "preview", "preprod"]>;
+/** Clamp an integer into [min, max] (used for limits the server also clamps). */
+export declare const clampedInt: (what: string, min: number, max: number, fallback: number) => z.ZodEffects<z.ZodOptional<z.ZodNumber>, number, number | undefined>;

package/dist/schemas.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+/*
+ * Shared zod helpers for Cardano-native shapes. Validation happens in the MCP
+ * layer so obviously malformed input never reaches ODATANO (and the agent
+ * gets a precise message instead of a generic 400).
+ */
+const HEX = /^[0-9a-fA-F]+$/;
+export const hex64 = (what) => z.string().regex(/^[0-9a-fA-F]{64}$/, `${what} must be 64 hex characters (32 bytes)`);
+export const hex56 = (what) => z.string().regex(/^[0-9a-fA-F]{56}$/, `${what} must be 56 hex characters (28 bytes)`);
+/** Any even-length hex string (CBOR, COSE, scripts). */
+export const hexString = (what, max = 1_000_000) => z.string().min(2).max(max).regex(HEX, `${what} must be hex`).refine((s) => s.length % 2 === 0, {
+    message: `${what} must have an even number of hex characters`,
+});
+/**
+ * Bech32 Cardano address (payment or stake). Loose check: prefix + charset +
+ * length; the server does the checksum. Accepts addr / addr_test / stake /
+ * stake_test.
+ */
+export const bech32Address = z.string()
+    .regex(/^(addr|addr_test|stake|stake_test)1[02-9ac-hj-np-z]{20,120}$/, 'must be a bech32 Cardano address (addr…/addr_test…/stake…/stake_test…)');
+export const stakeAddress = z.string()
+    .regex(/^(stake|stake_test)1[02-9ac-hj-np-z]{20,80}$/, 'must be a bech32 stake address (stake…/stake_test…)');
+export const poolId = z.string()
+    .regex(/^pool1[02-9ac-hj-np-z]{20,70}$/, 'must be a bech32 pool id (pool1…)');
+export const drepId = z.string()
+    .regex(/^drep(_script)?1[02-9ac-hj-np-z]{20,70}$/, 'must be a bech32 DRep id (drep1… / drep_script1…)');
+/** `policyId (56 hex) + assetNameHex (0..64 hex)`; `lovelace` is also accepted where the server does. */
+export const assetUnit = z.string()
+    .regex(/^[0-9a-fA-F]{56}(?:[0-9a-fA-F]{2}){0,32}$/, 'must be policyId (56 hex) + assetNameHex (up to 64 hex)');
+/**
+ * Non-negative integer amount as decimal string (preferred, exact) or JS
+ * number. Always forwarded to ODATANO as a string so nothing is rounded.
+ */
+export const amount = (what) => z.union([
+    z.string().regex(/^\d+$/, `${what} must be a non-negative integer (decimal string)`),
+    z.number().int().nonnegative(),
+]).transform((v) => String(v));
+/** Positive integer amount (>= 1). */
+export const positiveAmount = (what) => z.union([
+    z.string().regex(/^[1-9]\d*$/, `${what} must be a positive integer (decimal string)`),
+    z.number().int().positive(),
+]).transform((v) => String(v));
+/** Posix milliseconds as decimal string or number, forwarded as string. */
+export const posixMs = amount;
+/** A string that must parse as JSON (objects/arrays are passed pre-stringified to ODATANO). */
+export const jsonString = (what, kind = 'any') => z.string().min(1).superRefine((s, ctx) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(s);
+    }
+    catch {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: `${what} must be a JSON string` });
+        return;
+    }
+    if (kind === 'array' && !Array.isArray(parsed)) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: `${what} must be a JSON array` });
+    }
+    if (kind === 'object' && (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: `${what} must be a JSON object` });
+    }
+});
+/**
+ * JSON that the agent may pass either as a string or as a native value; the
+ * native form is stringified before it reaches ODATANO. Convenient for
+ * datums / redeemers / metadata objects.
+ */
+export const jsonValue = (what, kind = 'any') => z.union([
+    jsonString(what, kind),
+    kind === 'array' ? z.array(z.unknown()) : kind === 'object' ? z.record(z.unknown()) : z.unknown(),
+]).transform((v) => (typeof v === 'string' ? v : JSON.stringify(v)));
+export const uuid = (what) => z.string().uuid(`${what} must be a UUID`);
+export const network = z.enum(['mainnet', 'preview', 'preprod']);
+/** Clamp an integer into [min, max] (used for limits the server also clamps). */
+export const clampedInt = (what, min, max, fallback) => z.number().int().min(min, `${what} must be >= ${min}`).max(max, `${what} must be <= ${max}`).optional()
+    .transform((v) => v ?? fallback);
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OdatanoClient } from './client.js';
+import type { OdatanoMcpConfig } from './config.js';
+import { type Capabilities } from './tools/index.js';
+export declare const SERVER_VERSION = "0.1.0";
+/**
+ * Probe which optional (v2.0) services the host serves. Both probes run in
+ * parallel and never throw; an unreachable host simply yields no v2.0 tools
+ * (the core tools are registered regardless and report errors per call).
+ */
+export declare function detectCapabilities(client: OdatanoClient): Promise<Capabilities>;
+/**
+ * Build the MCP server with all tools registered; transport is the caller's
+ * choice. `caps` defaults to "core only" so callers that cannot reach the host
+ * (unit tests, schema inspection) get a deterministic tool set.
+ */
+export declare function buildServer(config: OdatanoMcpConfig, caps?: Capabilities): McpServer;

package/dist/server.js

@@ -0,0 +1,27 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OdatanoClient } from './client.js';
+import { registerTools } from './tools/index.js';
+export const SERVER_VERSION = '0.1.0';
+/**
+ * Probe which optional (v2.0) services the host serves. Both probes run in
+ * parallel and never throw; an unreachable host simply yields no v2.0 tools
+ * (the core tools are registered regardless and report errors per call).
+ */
+export async function detectCapabilities(client) {
+    const [worker, indexer] = await Promise.all([
+        client.serviceExists('worker'),
+        client.serviceExists('indexer'),
+    ]);
+    return { worker, indexer };
+}
+/**
+ * Build the MCP server with all tools registered; transport is the caller's
+ * choice. `caps` defaults to "core only" so callers that cannot reach the host
+ * (unit tests, schema inspection) get a deterministic tool set.
+ */
+export function buildServer(config, caps = { worker: false, indexer: false }) {
+    const server = new McpServer({ name: 'odatano', version: SERVER_VERSION });
+    registerTools(server, { client: new OdatanoClient(config), config }, caps);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAqB;IAC5D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC9B,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAwB,EAAE,OAAqB,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;IAC1G,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3E,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/build.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './shared.js';
+export declare function registerBuildTools(server: McpServer, ctx: ToolContext): void;

package/dist/tools/build.js

@@ -0,0 +1,208 @@
+import { z } from 'zod';
+import { amount, bech32Address, hex64, hexString, jsonValue, network, posixMs, uuid, } from '../schemas.js';
+import { JSON_HINT, makeRunner, UNSIGNED_HINT } from './shared.js';
+/*
+ * Build tools over CardanoTransactionService. Every Build* action returns a
+ * TransactionBuilds row: { id (buildId), unsignedTxCbor, fee, ttl, status,
+ * scriptAddress?, scriptHash?, ... }. Nothing is signed here - the host never
+ * holds the sender's key in this flow - so exposing the full parameter set is
+ * safe: the worst outcome of a bad build is an unsigned CBOR nobody signs.
+ */
+const validityBounds = {
+    validityStartMs: posixMs('validityStartMs').optional()
+        .describe('Optional validity-interval start, Posix milliseconds'),
+    validityEndMs: posixMs('validityEndMs').optional()
+        .describe('Optional validity-interval end, Posix milliseconds'),
+};
+const scriptParams = {
+    scriptParamsJson: jsonValue('scriptParamsJson', 'array').optional()
+        .describe('Optional JSON array of PlutusData parameters applied to the script before hashing/building ' +
+        '(parameterized validators). Typed entries {"uplc":"data"|"bytes"|"int"|"bool"|"unit","value":…} are ' +
+        'applied as native UPLC constants; bare PlutusData entries mean "data".'),
+};
+const forceInputs = {
+    forceInputsJson: jsonValue('forceInputsJson', 'array').optional()
+        .describe('Optional JSON array of {txHash, outputIndex} UTxOs that MUST be consumed (one-shot mint seeds, ' +
+        'token-carrying UTxOs, deterministic input control)'),
+};
+const referenceInputs = {
+    referenceInputsJson: jsonValue('referenceInputsJson', 'array').optional()
+        .describe('Optional JSON array of {txHash, outputIndex} CIP-31 reference inputs (read-only, not consumed): ' +
+        'oracle feeds, shared config UTxOs, reference-script UTxOs'),
+};
+const referenceScript = {
+    referenceScriptHex: hexString('referenceScriptHex').optional()
+        .describe('Optional Plutus V3 validator CBOR hex attached as CIP-33 reference script on the primary output. ' +
+        'Inflates the output min-ADA significantly - lovelaceAmount must cover it.'),
+};
+const requiredSigners = {
+    requiredSignersJson: jsonValue('requiredSignersJson', 'array').optional()
+        .describe('Optional JSON array of 28-byte Ed25519 key hashes (56 hex each) that must sign; needed by validators ' +
+        'checking extra_signatories. Get a hash via extract_payment_key_hash.'),
+};
+export function registerBuildTools(server, ctx) {
+    const { client } = ctx;
+    const run = makeRunner(ctx);
+    server.registerTool('build_ada_transfer', {
+        description: 'Build a simple ADA transfer (optionally carrying native assets, an inline datum, or locking at a ' +
+            'Plutus script address). Coin selection, fee and change are computed by the host (Buildooor).' +
+            UNSIGNED_HINT + JSON_HINT,
+        inputSchema: {
+            senderAddress: bech32Address.describe('Sender / fee payer (bech32)'),
+            recipientAddress: bech32Address.describe('Recipient (bech32); ignored when lockOnScript is true'),
+            lovelaceAmount: amount('lovelaceAmount').describe('Amount in lovelace (1 ADA = 1000000)'),
+            changeAddress: bech32Address.optional().describe('Change address; defaults to senderAddress'),
+            outputDatumJson: jsonValue('outputDatumJson').optional()
+                .describe('Optional inline datum for the recipient output (PlutusData JSON, DetailedSchema). Required when sending to a script address.'),
+            assetsJson: jsonValue('assetsJson', 'array').optional()
+                .describe('Optional native assets for the output: [{"unit":"policyId+assetNameHex","quantity":"amount"}]'),
+            ...forceInputs,
+            validatorScript: hexString('validatorScript').optional()
+                .describe('Optional Plutus validator CBOR hex; required when lockOnScript is true (used only to derive the target script address)'),
+            ...scriptParams,
+            lockOnScript: z.boolean().optional()
+                .describe('When true, route the output to the enterprise script address derived from validatorScript (+ scriptParamsJson) instead of recipientAddress'),
+            ...referenceScript,
+            ...validityBounds,
+        },
+    }, run(async (args) => client.callAction('transaction', 'BuildSimpleAdaTransaction', args), { keepCbor: true }));
+    server.registerTool('build_metadata_transaction', {
+        description: 'Build an ADA transfer that carries transaction metadata (CIP-20 message, label-1447 financial anchor, ' +
+            'any label -> JSON). Use lovelaceAmount = min-ADA and recipient = sender for a pure anchoring tx.' +
+            UNSIGNED_HINT + JSON_HINT,
+        inputSchema: {
+            senderAddress: bech32Address.describe('Sender / fee payer (bech32)'),
+            recipientAddress: bech32Address.describe('Recipient (bech32); may equal senderAddress'),
+            lovelaceAmount: amount('lovelaceAmount').describe('Amount in lovelace'),
+            changeAddress: bech32Address.optional().describe('Change address; defaults to senderAddress'),
+            metadataJson: jsonValue('metadataJson', 'object')
+                .describe('Metadata as JSON object keyed by numeric label string, e.g. {"674":{"msg":["hello"]}}'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'BuildTransactionWithMetadata', args), { keepCbor: true }));
+    server.registerTool('build_multi_asset_transfer', {
+        description: 'Build a transfer of native assets (tokens / NFTs) together with ADA to one recipient.' +
+            UNSIGNED_HINT + JSON_HINT,
+        inputSchema: {
+            senderAddress: bech32Address.describe('Sender / fee payer (bech32)'),
+            recipientAddress: bech32Address.describe('Recipient (bech32)'),
+            lovelaceAmount: amount('lovelaceAmount').describe('Lovelace to send along (must cover min-ADA of the token output)'),
+            assetsJson: jsonValue('assetsJson', 'array')
+                .describe('Assets to send: [{"unit":"policyId+assetNameHex","quantity":"amount"}]'),
+            changeAddress: bech32Address.optional().describe('Change address; defaults to senderAddress'),
+            outputDatumJson: jsonValue('outputDatumJson').optional()
+                .describe('Optional inline datum for the recipient output (PlutusData JSON). Required for script addresses.'),
+            ...referenceScript,
+            ...validityBounds,
+        },
+    }, run(async (args) => client.callAction('transaction', 'BuildMultiAssetTransaction', args), { keepCbor: true }));
+    server.registerTool('build_mint_transaction', {
+        description: 'Build a mint or burn of native assets under a Plutus (V3) minting policy. Supports parameterized policies, ' +
+            'required signers, inline datum on the recipient output, CIP-31 reference inputs, CIP-33 reference-script ' +
+            'deploy, metadata (CIP-25 label 721 goes in metadataJson) and forced inputs for one-shot policies. ' +
+            'Redeemer/datum JSON may contain __INPUT_IDX:<txHash>#<outputIndex>__ placeholders that resolve to the ' +
+            'input index after coin selection.' + UNSIGNED_HINT + JSON_HINT,
+        inputSchema: {
+            senderAddress: bech32Address.describe('Sender / fee payer (bech32)'),
+            recipientAddress: bech32Address.describe('Receiver of the minted assets (bech32)'),
+            lovelaceAmount: amount('lovelaceAmount').describe('Lovelace sent with the minted assets (must cover min-ADA)'),
+            mintActionsJson: jsonValue('mintActionsJson', 'array')
+                .describe('Mint/burn actions: [{"assetUnit":"policyId+assetNameHex","quantity":"amount"}] (negative quantity = burn)'),
+            mintingPolicyScript: hexString('mintingPolicyScript').describe('Minting policy script CBOR hex (as emitted by Aiken/Plutus; do NOT unwrap)'),
+            changeAddress: bech32Address.optional().describe('Change address; defaults to senderAddress'),
+            ...requiredSigners,
+            ...scriptParams,
+            inlineDatumJson: jsonValue('inlineDatumJson').optional()
+                .describe('Optional PlutusData JSON inline datum on the recipient output (tokens carrying state)'),
+            mintRedeemerJson: jsonValue('mintRedeemerJson').optional()
+                .describe('Optional PlutusData JSON redeemer for the policy; defaults to integer 0'),
+            lockOnScript: z.boolean().optional()
+                .describe('When true (with scriptParamsJson), route the output to the applied script\'s enterprise address instead of recipientAddress'),
+            ...forceInputs,
+            ...referenceInputs,
+            metadataJson: jsonValue('metadataJson', 'object').optional()
+                .describe('Optional metadata object keyed by numeric label string (CIP-25: {"721":{...}})'),
+            ...referenceScript,
+            ...validityBounds,
+        },
+    }, run(async (args) => client.callAction('transaction', 'BuildMintTransaction', args), { keepCbor: true }));
+    server.registerTool('build_plutus_spend', {
+        description: 'Build a transaction spending a UTxO locked at a Plutus (V3) script address: validator + redeemer + the ' +
+            'script UTxO (txHash#index), optional datum (hash-based), continuing-output inline datum, extra outputs, ' +
+            'combined mint, CIP-31 reference inputs, CIP-33 reference script, required signers. The host evaluates ' +
+            'the script locally for the ExUnits budget; on-chain validation at submit stays authoritative.' +
+            UNSIGNED_HINT + JSON_HINT,
+        inputSchema: {
+            senderAddress: bech32Address.describe('Fee payer / collateral provider (bech32)'),
+            recipientAddress: bech32Address.describe('Receiver of the unlocked funds (bech32)'),
+            lovelaceAmount: amount('lovelaceAmount').describe('Lovelace to send to recipientAddress'),
+            validatorScript: hexString('validatorScript').describe('Plutus validator CBOR hex (as emitted by the compiler; do NOT unwrap)'),
+            scriptTxHash: hex64('scriptTxHash').describe('Tx hash of the UTxO locked at the script address'),
+            scriptOutputIndex: z.number().int().nonnegative().describe('Output index of the locked UTxO'),
+            redeemerJson: jsonValue('redeemerJson').describe('Redeemer as PlutusData JSON (constructor/fields, int, bytes, list, map)'),
+            datumJson: jsonValue('datumJson').optional().describe('Optional datum PlutusData JSON (only for hash-based datums; inline datums are read from the UTxO)'),
+            changeAddress: bech32Address.optional().describe('Change address; defaults to senderAddress'),
+            ...requiredSigners,
+            ...scriptParams,
+            inlineDatumJson: jsonValue('inlineDatumJson').optional()
+                .describe('Optional PlutusData JSON inline datum for the recipient output (state-machine continuing output)'),
+            lockOnScript: z.boolean().optional()
+                .describe('When true (with scriptParamsJson), route the output back to the applied script\'s enterprise address'),
+            ...forceInputs,
+            extraOutputsJson: jsonValue('extraOutputsJson', 'array').optional()
+                .describe('Optional additional outputs after the primary one: [{address, lovelaceAmount, assets?:[{unit,quantity}], inlineDatumJson?, referenceScriptHex?}]'),
+            mintActionsJson: jsonValue('mintActionsJson', 'array').optional()
+                .describe('Optional mint/burn actions for a combined spend+mint: [{"assetUnit","quantity"}]; requires mintingPolicyScript'),
+            mintingPolicyScript: hexString('mintingPolicyScript').optional()
+                .describe('Optional minting policy CBOR hex (required with mintActionsJson; if byte-equal to validatorScript, scriptParamsJson applies to it too)'),
+            mintRedeemerJson: jsonValue('mintRedeemerJson').optional()
+                .describe('Optional PlutusData JSON redeemer for the policy; defaults to integer 0; supports __INPUT_IDX__ placeholders'),
+            ...referenceInputs,
+            ...referenceScript,
+            ...validityBounds,
+        },
+    }, run(async (args) => client.callAction('transaction', 'BuildPlutusSpendTransaction', args), { keepCbor: true }));
+    server.registerTool('set_collateral', {
+        description: 'Ensure a dedicated ADA-only collateral UTxO exists for Plutus transactions: checks the address for ' +
+            '>= 2 UTxOs of >= 5 ADA and, if missing, builds a self-send that creates a 5 ADA UTxO. Returns the ' +
+            'build (to sign + submit) or a no-op result when collateral is already fine.' + UNSIGNED_HINT,
+        inputSchema: {
+            address: bech32Address.describe('Address to check / prepare (bech32)'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'SetCollateral', { address: args.address }), { keepCbor: true }));
+    server.registerTool('get_build_details', {
+        description: 'Re-fetch a transaction build by buildId: unsigned CBOR, fee, ttl, status (built / signed / submitted), ' +
+            'derived script address, inputs/outputs recorded at build time. Returns found:false for unknown ids.',
+        inputSchema: {
+            buildId: uuid('buildId').describe('Build id returned by a build_* tool'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'GetBuildDetails', { buildId: args.buildId }), {
+        keepCbor: true,
+        notFoundAs: (args) => ({ buildId: args.buildId }),
+    }));
+    server.registerTool('list_builds_by_address', {
+        description: 'Transaction builds recorded for a sender address (build audit trail): buildId, status, fee, created time.',
+        inputSchema: {
+            address: bech32Address.describe('Sender address (bech32)'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'GetTransactionBuildsByAddress', { address: args.address }), {
+        notFoundAs: (args) => ({ address: args.address }),
+    }));
+    server.registerTool('derive_script_address', {
+        description: 'Utility: apply optional PlutusData parameters to a validator script and return its enterprise script ' +
+            'address (bech32) and 28-byte script hash. Pure derivation - no transaction, no chain call. Script hex ' +
+            'from Aiken/Plutus compilers is CBOR-wrapped flat UPLC; pass it as-is (unwrapping changes the hash).' + JSON_HINT,
+        inputSchema: {
+            validatorScript: hexString('validatorScript').describe('Validator script CBOR hex'),
+            ...scriptParams,
+            network: network.optional().describe('Network override for the address prefix; defaults to the host network'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'DeriveScriptAddress', args)));
+    server.registerTool('extract_payment_key_hash', {
+        description: 'Utility: decode a bech32 address and return its 28-byte payment credential hash (56 hex). Pure ' +
+            'decoding, no chain call. Use it for requiredSignersJson or credential-based UTxO queries.',
+        inputSchema: {
+            address: bech32Address.describe('Bech32 address (addr… / addr_test…)'),
+        },
+    }, run(async (args) => client.callAction('transaction', 'ExtractPaymentKeyHash', { address: args.address })));
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type QueryCapabilities } from './query.js';
+import type { ToolContext } from './shared.js';
+export type Capabilities = QueryCapabilities;
+/**
+ * Register the tool catalogue. Reads, generic query, unsigned builds and the
+ * signing handoff are always present; the v2.0 worker / indexer tools only
+ * when the host serves those services (see OdatanoClient.serviceExists).
+ * HSM signing and every Admin action are deliberately never registered.
+ */
+export declare function registerTools(server: McpServer, ctx: ToolContext, caps: Capabilities): void;

package/dist/tools/index.js

@@ -0,0 +1,23 @@
+import { registerBuildTools } from './build.js';
+import { registerIndexerTools } from './indexer.js';
+import { registerQueryTools } from './query.js';
+import { registerReadTools } from './read.js';
+import { registerSignTools } from './sign.js';
+import { registerWorkerTools } from './worker.js';
+/**
+ * Register the tool catalogue. Reads, generic query, unsigned builds and the
+ * signing handoff are always present; the v2.0 worker / indexer tools only
+ * when the host serves those services (see OdatanoClient.serviceExists).
+ * HSM signing and every Admin action are deliberately never registered.
+ */
+export function registerTools(server, ctx, caps) {
+    registerReadTools(server, ctx);
+    registerQueryTools(server, ctx, caps);
+    registerBuildTools(server, ctx);
+    registerSignTools(server, ctx);
+    if (caps.worker)
+        registerWorkerTools(server, ctx);
+    if (caps.indexer)
+        registerIndexerTools(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAA0B,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,GAAgB,EAAE,IAAkB;IACnF,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM;QAAE,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,OAAO;QAAE,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/tools/indexer.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './shared.js';
+export declare function registerIndexerTools(server: McpServer, ctx: ToolContext): void;