obyte-mcp 0.1.0

package/dist/tools.js

@@ -0,0 +1,294 @@
+import { executeEnvelope } from "./envelope.js";
+import { assertNoSecrets } from "./secretGuard.js";
+import * as schemas from "./schemas.js";
+import { getAssetBySymbol, getDecimalsBySymbolOrAsset, getOfficialTokenRegistryAddress, getSymbolByAsset, resolveAsset } from "./symbols.js";
+import { textResult } from "./toolResult.js";
+export function registerObyteTools(server, client, config) {
+    const context = { server, client, config };
+    for (const tool of [...recommendedTools(context), ...rawTools(context), ...symbolTools(context)]) {
+        registerTool(context, tool);
+    }
+}
+function registerTool(context, tool) {
+    context.server.registerTool(tool.name, {
+        title: tool.title,
+        description: tool.description,
+        inputSchema: tool.schema,
+        annotations: {
+            title: tool.title,
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+            ...(tool.dryRun ? {} : { idempotentHint: true })
+        }
+    }, async (args) => {
+        const text = await executeEnvelope(context.config, tool.name, () => context.client.retryCount, async () => {
+            assertNoSecrets(args);
+            return tool.handler(args);
+        });
+        return textResult(text);
+    });
+}
+function recommendedTools(context) {
+    const { client, config } = context;
+    return [
+        {
+            name: "obyte_analyze_address",
+            title: "Analyze Obyte Address",
+            schema: schemas.analyzeAddressSchema,
+            description: "Recommended first tool for understanding an Obyte address on the configured network. Returns balances and optional definition, profile units, attestations, and bounded history. Use this instead of several raw calls when an agent needs an address overview. Output is a stable JSON envelope and may be truncated.",
+            handler: async (args) => {
+                const [balances, profileUnits, definition, attestations, history] = await Promise.all([
+                    client.getBalances([args.address]),
+                    client.getProfileUnits([args.address]),
+                    args.include_definition ? client.getDefinition(args.address).catch((error) => ({ error: String(error) })) : undefined,
+                    args.include_attestations ? client.getAttestations(args.address).catch((error) => ({ error: String(error) })) : undefined,
+                    args.include_history ? client.getHistory([args.address]).catch((error) => ({ error: String(error) })) : undefined
+                ]);
+                return { address: args.address, balances, profile_units: profileUnits, definition, attestations, history };
+            }
+        },
+        {
+            name: "obyte_analyze_unit",
+            title: "Analyze Obyte Unit",
+            schema: schemas.analyzeUnitSchema,
+            description: "Recommended tool for inspecting one Obyte unit. Fetches the joint and, when requested, follows the AA response chain for trigger units. Use when the user provides a unit hash and asks what happened. Output is hub data wrapped in a stable JSON envelope.",
+            handler: async (args) => ({
+                unit: args.unit,
+                joint: await client.getJoint(args.unit),
+                aa_response_chain: args.include_aa_response_chain ? await client.getAaResponseChain(args.unit).catch(() => null) : undefined
+            })
+        },
+        {
+            name: "obyte_analyze_aa",
+            title: "Analyze Autonomous Agent",
+            schema: schemas.analyzeAaSchema,
+            description: "Recommended tool for summarizing an autonomous agent. Returns AA balances, selected state vars by prefix, and optional AA responses. Use for AA debugging or state inspection. State vars are sorted by key and output may be truncated.",
+            handler: async (args) => ({
+                address: args.address,
+                balances: args.include_balances ? await client.getAaBalances(args.address) : undefined,
+                state_vars: args.state_var_prefix ? await client.getAaStateVars(args.address, args.state_var_prefix) : undefined,
+                aa_responses: args.include_responses ? await client.getAaResponses(args.address) : undefined
+            })
+        },
+        {
+            name: "obyte_resolve_asset",
+            title: "Resolve Obyte Asset",
+            schema: schemas.resolveAssetSchema,
+            description: "Recommended tool for resolving an asset id or token symbol in the configured registry. Returns asset, symbol, and decimals when available. Registry mappings are convenience metadata, not proof of legitimacy.",
+            handler: async (args) => resolveAsset(client, args.value, {
+                configuredRegistryAddress: config.tokenRegistryAddress,
+                tokenRegistryAddress: args.token_registry_address
+            })
+        },
+        {
+            name: "obyte_prepare_aa_dry_run",
+            title: "Prepare AA Dry Run",
+            schema: schemas.prepareAaDryRunSchema,
+            dryRun: true,
+            description: "Recommended tool for simulating an autonomous-agent trigger through the configured hub. This does not sign, broadcast, or mutate local state. Dry-run tools are not marked idempotent and are not retried by default.",
+            handler: async (args) => ({ address: args.address, dry_run: await client.dryRunAa(args.address, args.trigger) })
+        },
+        {
+            name: "obyte_get_portfolio_summary",
+            title: "Get Portfolio Summary",
+            schema: schemas.portfolioSummarySchema,
+            description: "Recommended tool for summarizing balances for up to 20 addresses. Optionally enriches asset ids with symbols and decimals from the selected token registry. Use for user-facing balance explanations rather than raw get_balances.",
+            handler: async (args) => {
+                const balances = await client.getBalances(args.addresses);
+                return {
+                    addresses: args.addresses,
+                    balances,
+                    symbol_resolution: args.resolve_symbols
+                        ? { note: "Use obyte_resolve_asset for per-asset details when the balance map contains non-base assets." }
+                        : undefined
+                };
+            }
+        }
+    ];
+}
+function rawTools(context) {
+    const { client, config } = context;
+    return [
+        {
+            name: "obyte_get_network_info",
+            title: "Get Obyte Network Info",
+            schema: schemas.networkInfoSchema,
+            description: "Returns the effective MCP runtime configuration: network, hub URL, token registry, config precedence, limits, and witnesses cache metadata. Use before other calls when network selection matters.",
+            handler: async () => ({ ...config, witnesses_cache: client.getWitnessesCacheInfo() })
+        },
+        {
+            name: "obyte_get_last_mci",
+            title: "Get Last MCI",
+            schema: schemas.emptySchema,
+            description: "Raw hub read. Returns the last main chain index known by the configured Obyte hub.",
+            handler: async () => client.getLastMci()
+        },
+        {
+            name: "obyte_get_peers",
+            title: "Get Hub Peers",
+            schema: schemas.emptySchema,
+            description: "Raw hub read. Returns peers known by the configured Obyte hub. Use for network diagnostics, not address analysis.",
+            handler: async () => client.getPeers()
+        },
+        {
+            name: "obyte_get_witnesses",
+            title: "Get Witnesses",
+            schema: schemas.getWitnessesSchema,
+            description: "Raw hub read. Returns witnesses for the configured network. Results are cached in memory for 10 minutes per network+hub unless update is true.",
+            handler: async (args) => client.getWitnesses(args.update)
+        },
+        {
+            name: "obyte_get_joint",
+            title: "Get Joint",
+            schema: schemas.getJointSchema,
+            description: "Raw hub read. Fetches the joint for one unit hash from the configured hub.",
+            handler: async (args) => client.getJoint(args.unit)
+        },
+        {
+            name: "obyte_get_balances",
+            title: "Get Balances",
+            schema: schemas.addressesSchema,
+            description: "Raw hub read. Fetches balances for 1 to 20 addresses. Use obyte_get_portfolio_summary for agent-friendly summaries.",
+            handler: async (args) => client.getBalances(args.addresses)
+        },
+        {
+            name: "obyte_get_profile_units",
+            title: "Get Profile Units",
+            schema: schemas.addressesSchema,
+            description: "Raw hub read. Returns profile units for 1 to 20 addresses when available.",
+            handler: async (args) => client.getProfileUnits(args.addresses)
+        },
+        {
+            name: "obyte_get_definition",
+            title: "Get Address Definition",
+            schema: schemas.getDefinitionSchema,
+            description: "Raw hub read. Returns the definition of one Obyte address.",
+            handler: async (args) => client.getDefinition(args.address)
+        },
+        {
+            name: "obyte_get_data_feed",
+            title: "Get Data Feed",
+            schema: schemas.getDataFeedSchema,
+            description: "Raw hub read. Reads a data feed by oracle addresses and feed name. Oracle arrays are limited to 10 entries.",
+            handler: async (args) => client.getDataFeed(args.oracles, args.feed_name, args.ifnone)
+        },
+        {
+            name: "obyte_get_history",
+            title: "Get Address History",
+            schema: schemas.getHistorySchema,
+            description: "Raw hub read. Returns history for 1 to 20 addresses. If witnesses are omitted, the server uses the 10-minute witnesses cache or fetches witnesses from the hub.",
+            handler: async (args) => client.getHistory(args.addresses, args.witnesses, args.update_witnesses)
+        },
+        {
+            name: "obyte_get_attestation",
+            title: "Get Attestation",
+            schema: schemas.getAttestationSchema,
+            description: "Raw hub read. Looks up one attestation by attestor address, field, and value.",
+            handler: async (args) => client.getAttestation(args.attestor_address, args.field, args.value)
+        },
+        {
+            name: "obyte_get_attestations",
+            title: "Get Address Attestations",
+            schema: schemas.getAttestationsSchema,
+            description: "Raw hub read. Returns attestations associated with one address.",
+            handler: async (args) => client.getAttestations(args.address)
+        },
+        {
+            name: "obyte_get_aa_response_chain",
+            title: "Get AA Response Chain",
+            schema: schemas.triggerUnitSchema,
+            description: "Raw hub read. Returns the autonomous-agent response chain for a trigger unit.",
+            handler: async (args) => client.getAaResponseChain(args.trigger_unit)
+        },
+        {
+            name: "obyte_get_aa_responses",
+            title: "Get AA Responses",
+            schema: schemas.aaOrAasSchema,
+            description: "Raw hub read. Returns AA responses for one AA address or up to 20 AA addresses.",
+            handler: async (args) => client.getAaResponses(args.aa ?? args.aas)
+        },
+        {
+            name: "obyte_get_aas_by_base_aas",
+            title: "Get AAs By Base AAs",
+            schema: schemas.baseAaOrAasSchema,
+            description: "Raw hub read. Returns AAs derived from one base AA or up to 20 base AAs.",
+            handler: async (args) => client.getAasByBaseAas(args.base_aa ?? args.base_aas)
+        },
+        {
+            name: "obyte_dry_run_aa",
+            title: "Dry Run AA",
+            schema: schemas.dryRunAaSchema,
+            dryRun: true,
+            description: "Raw hub dry run. Simulates triggering an autonomous agent with a JSON trigger payload. It does not sign or broadcast. Not retried by default and not marked idempotent.",
+            handler: async (args) => client.dryRunAa(args.address, args.trigger)
+        },
+        {
+            name: "obyte_execute_getter",
+            title: "Execute AA Getter",
+            schema: schemas.executeGetterSchema,
+            description: "Raw hub read. Executes an autonomous-agent getter with optional JSON args and returns the getter result.",
+            handler: async (args) => client.executeGetter(args.address, args.getter, args.args)
+        },
+        {
+            name: "obyte_get_aa_balances",
+            title: "Get AA Balances",
+            schema: schemas.aaAddressSchema,
+            description: "Raw hub read. Returns balances held by one autonomous agent address.",
+            handler: async (args) => client.getAaBalances(args.address)
+        },
+        {
+            name: "obyte_get_aa_state_vars",
+            title: "Get AA State Vars",
+            schema: schemas.getAaStateVarsSchema,
+            description: "Raw hub read. Returns autonomous-agent state variables, optionally bounded by prefix/range. Prefix length is limited to 128 characters. Map-like output is sorted by key.",
+            handler: async (args) => client.getAaStateVars(args.address, args.var_prefix, args.var_prefix_from, args.var_prefix_to)
+        }
+    ];
+}
+function symbolTools(context) {
+    const { client, config } = context;
+    return [
+        {
+            name: "obyte_get_official_token_registry_address",
+            title: "Get Token Registry Address",
+            schema: schemas.registrySchema,
+            description: "Returns the selected token registry address. The mainnet default comes from obyte.js; custom and testnet registries must be explicitly trusted by the user.",
+            handler: async (args) => ({
+                token_registry_address: args.token_registry_address ?? getOfficialTokenRegistryAddress(config.tokenRegistryAddress),
+                trust_model: "Registry mappings are metadata convenience, not proof of asset legitimacy."
+            })
+        },
+        {
+            name: "obyte_get_symbol_by_asset",
+            title: "Get Symbol By Asset",
+            schema: schemas.symbolByAssetSchema,
+            description: "Resolves an Obyte asset id to a token symbol through the selected registry. base/null maps to GBYTE; unknown assets fall back to the first sanitized asset characters as in obyte.js.",
+            handler: async (args) => getSymbolByAsset(client, args.asset, {
+                configuredRegistryAddress: config.tokenRegistryAddress,
+                tokenRegistryAddress: args.token_registry_address
+            })
+        },
+        {
+            name: "obyte_get_asset_by_symbol",
+            title: "Get Asset By Symbol",
+            schema: schemas.assetBySymbolSchema,
+            description: "Resolves a token symbol to an Obyte asset id through the selected registry. GBYTE, MBYTE, KBYTE, and BYTE resolve to base.",
+            handler: async (args) => getAssetBySymbol(client, args.symbol, {
+                configuredRegistryAddress: config.tokenRegistryAddress,
+                tokenRegistryAddress: args.token_registry_address
+            })
+        },
+        {
+            name: "obyte_get_decimals_by_symbol_or_asset",
+            title: "Get Decimals By Symbol Or Asset",
+            schema: schemas.decimalsSchema,
+            description: "Returns decimals for base aliases or a registry-known token symbol/asset. base and GBYTE use 9, MBYTE 6, KBYTE 3, BYTE 0. Registry data is untrusted metadata.",
+            handler: async (args) => getDecimalsBySymbolOrAsset(client, args.symbol_or_asset, {
+                configuredRegistryAddress: config.tokenRegistryAddress,
+                tokenRegistryAddress: args.token_registry_address
+            })
+        }
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type Network = "mainnet" | "testnet";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type ErrorCode = "VALIDATION_ERROR" | "CONFIG_ERROR" | "HUB_ERROR" | "TIMEOUT" | "NETWORK_ERROR" | "OUTPUT_TOO_LARGE" | "SECRET_INPUT_REJECTED" | "INTERNAL_ERROR";
+export interface RuntimeConfig {
+    network: Network;
+    hubAddress: string;
+    tokenRegistryAddress: string | undefined;
+    timeoutMs: number;
+    maxConcurrency: number;
+    maxOutputBytes: number;
+    source: {
+        network: "env" | "cli" | "default";
+        hubAddress: "env" | "cli" | "default";
+        tokenRegistryAddress: "env" | "cli" | "default" | "unset";
+        timeoutMs: "env" | "cli" | "default";
+        maxConcurrency: "env" | "cli" | "default";
+        maxOutputBytes: "env" | "cli" | "default";
+    };
+}
+export interface CliOptions {
+    network?: Network | undefined;
+    hubAddress?: string | undefined;
+    tokenRegistryAddress?: string | undefined;
+    timeoutMs?: number | undefined;
+    maxConcurrency?: number | undefined;
+    maxOutputBytes?: number | undefined;
+}
+export interface ToolMeta {
+    network: Network;
+    hub: string;
+    tool: string;
+    request_id: string;
+    duration_ms: number;
+    retry_count: number;
+    truncated: boolean;
+    output_bytes_before_truncation?: number;
+    output_bytes_after_truncation?: number;
+    truncation_reason?: string;
+}
+export interface SuccessEnvelope {
+    ok: true;
+    meta: ToolMeta;
+    data: unknown;
+}
+export interface ErrorEnvelope {
+    ok: false;
+    meta: ToolMeta;
+    error: {
+        code: ErrorCode;
+        message: string;
+        details?: unknown;
+    };
+}
+export type ToolEnvelope = SuccessEnvelope | ErrorEnvelope;
+export interface ToolExecutionContext {
+    config: RuntimeConfig;
+    requestId: string;
+    toolName: string;
+    startedAt: number;
+    retryCount: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "obyte-mcp",
+  "version": "0.1.0",
+  "description": "Local stdio MCP server for querying Obyte hubs.",
+  "type": "module",
+  "bin": {
+    "obyte-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "obyte",
+    "mcp",
+    "model-context-protocol",
+    "autonomous-agents"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Taump/obyte-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0-beta.2",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15"
+  }
+}