obyte-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 obyte-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,551 @@
+# obyte-mcp
+
+Local stdio MCP server for querying Obyte hubs from AI tools.
+
+`obyte-mcp` exposes Obyte hub reads, autonomous-agent inspection, AA dry runs, and token symbol helpers to MCP clients such as Codex, Claude Desktop, and Claude Code.
+
+Official Obyte docs:
+
+- https://developer.obyte.org/
+- https://developer.obyte.org/autonomous-agents
+
+## What This Is
+
+- A local MCP server that talks over stdio only.
+- A read/query/dry-run connector for Obyte mainnet or testnet hubs.
+- A toolset for balances, units, witnesses, AA state vars, AA getters, AA dry runs, token symbols, and agent-friendly summaries.
+
+## What This Is Not
+
+- Not a wallet.
+- Not a signer.
+- Not a transaction broadcaster.
+- Not a service that opens a local TCP port.
+- Not a place to paste private keys, seed phrases, mnemonics, xprv values, passphrases, or other secrets.
+
+The server uses stdio only. It does not start an HTTP server and does not listen on a local TCP port.
+
+## Requirements
+
+- Node.js `>=20`
+- npm / npx
+- An MCP client that supports local stdio servers
+
+## Quick Start
+
+Run on mainnet:
+
+```bash
+npx -y obyte-mcp --network mainnet
+```
+
+Run on testnet:
+
+```bash
+npx -y obyte-mcp --network testnet
+```
+
+Interactive setup wizard:
+
+```bash
+npx -y obyte-mcp setup
+```
+
+Non-interactive config printing:
+
+```bash
+npx -y obyte-mcp setup --print-only --client codex --network mainnet
+npx -y obyte-mcp setup --print-only --client claude-desktop --network testnet
+npx -y obyte-mcp setup --print-only --client claude-code --network mainnet
+```
+
+Doctor:
+
+```bash
+npx -y obyte-mcp doctor
+npx -y obyte-mcp doctor --json
+```
+
+## Configuration
+
+Precedence is:
+
+1. Environment variables
+2. CLI flags
+3. Defaults
+
+| Env var | CLI flag | Default | Description |
+| --- | --- | --- | --- |
+| `OBYTE_NETWORK` | `--network` | `mainnet` | `mainnet` or `testnet` |
+| `OBYTE_HUB_ADDRESS` | `--hub` | Network default | Custom hub URL |
+| `OBYTE_TOKEN_REGISTRY_ADDRESS` | `--token-registry` | Mainnet registry on mainnet, unset on testnet | Token registry AA |
+| `OBYTE_REQUEST_TIMEOUT_MS` | `--timeout-ms` | `20000` | Hub request timeout, `1000..120000` |
+| `OBYTE_MAX_CONCURRENCY` | `--max-concurrency` | `4` | Concurrent hub requests, `1..10` |
+| `OBYTE_MAX_OUTPUT_BYTES` | `--max-output-bytes` | `262144` | Max tool output bytes, `16384..1048576` |
+
+Default hubs:
+
+- Mainnet: `https://obyte.org/api`
+- Testnet: `https://testnet.obyte.org/api`
+
+Custom hub URL policy:
+
+- `https:` is allowed.
+- `http:` is allowed only for `localhost`, `127.0.0.1`, and `::1`.
+- URL credentials are rejected.
+- Non-HTTP protocols are rejected.
+
+## Install In Codex
+
+Add a local stdio MCP server config with `npx`:
+
+```json
+{
+  "mcpServers": {
+    "obyte": {
+      "command": "npx",
+      "args": ["-y", "obyte-mcp", "--network", "mainnet"]
+    }
+  }
+}
+```
+
+Testnet:
+
+```json
+{
+  "mcpServers": {
+    "obyte-testnet": {
+      "command": "npx",
+      "args": ["-y", "obyte-mcp", "--network", "testnet"]
+    }
+  }
+}
+```
+
+With a custom testnet token registry:
+
+```json
+{
+  "mcpServers": {
+    "obyte-testnet": {
+      "command": "npx",
+      "args": ["-y", "obyte-mcp", "--network", "testnet", "--token-registry", "YOUR_TESTNET_REGISTRY_AA"]
+    }
+  }
+}
+```
+
+Version-tested note: this README should be updated before each release with the exact Codex version used for smoke testing. Other Codex versions may work if they support local stdio MCP servers.
+
+## Install In Claude Desktop
+
+Edit `claude_desktop_config.json`.
+
+Common paths:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+Mainnet:
+
+```json
+{
+  "mcpServers": {
+    "obyte": {
+      "command": "npx",
+      "args": ["-y", "obyte-mcp", "--network", "mainnet"]
+    }
+  }
+}
+```
+
+Testnet:
+
+```json
+{
+  "mcpServers": {
+    "obyte-testnet": {
+      "command": "npx",
+      "args": ["-y", "obyte-mcp", "--network", "testnet"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after editing the config.
+
+Version-tested note: this README should be updated before each release with the exact Claude Desktop version used for smoke testing. Other versions may work if they support local stdio MCP servers.
+
+## Install In Claude Code
+
+Mainnet:
+
+```bash
+claude mcp add --transport stdio obyte -- npx -y obyte-mcp --network mainnet
+```
+
+Testnet:
+
+```bash
+claude mcp add --transport stdio obyte-testnet -- npx -y obyte-mcp --network testnet
+```
+
+The `--` before `npx` is required. Without it, Claude Code can parse `obyte-mcp` flags such as `--network` as Claude Code flags instead of server flags.
+
+Useful Claude Code commands:
+
+```bash
+claude mcp list
+claude mcp get obyte
+```
+
+Inside Claude Code, use:
+
+```text
+/mcp
+```
+
+Version-tested note: this README should be updated before each release with the exact Claude Code version used for smoke testing. Other versions may work if they support local stdio MCP servers.
+
+## Recommended Tools
+
+Use these first for agent-facing tasks:
+
+- `obyte_analyze_address`: balances, profile units, definition, attestations, optional history.
+- `obyte_analyze_unit`: joint plus optional AA response chain.
+- `obyte_analyze_aa`: AA balances, selected state vars, optional responses.
+- `obyte_resolve_asset`: resolves asset/symbol/decimals in one call.
+- `obyte_prepare_aa_dry_run`: validates and dry-runs an AA trigger.
+- `obyte_get_portfolio_summary`: balances for up to 20 addresses.
+
+## Raw Hub Tools
+
+Advanced tools that mirror Obyte hub/client methods:
+
+- `obyte_get_network_info`
+- `obyte_get_last_mci`
+- `obyte_get_peers`
+- `obyte_get_witnesses`
+- `obyte_get_joint`
+- `obyte_get_balances`
+- `obyte_get_profile_units`
+- `obyte_get_definition`
+- `obyte_get_data_feed`
+- `obyte_get_history`
+- `obyte_get_attestation`
+- `obyte_get_attestations`
+- `obyte_get_aa_response_chain`
+- `obyte_get_aa_responses`
+- `obyte_get_aas_by_base_aas`
+- `obyte_dry_run_aa`
+- `obyte_execute_getter`
+- `obyte_get_aa_balances`
+- `obyte_get_aa_state_vars`
+
+## Symbol Tools
+
+- `obyte_get_official_token_registry_address`
+- `obyte_get_symbol_by_asset`
+- `obyte_get_asset_by_symbol`
+- `obyte_get_decimals_by_symbol_or_asset`
+
+Base asset decimals:
+
+- `base` and `GBYTE`: `9`
+- `MBYTE`: `6`
+- `KBYTE`: `3`
+- `BYTE`: `0`
+
+Mainnet default token registry:
+
+```text
+O6H6ZIFI57X3PLTYHOCVYPP5A553CYFQ
+```
+
+On testnet, pass a registry explicitly if you need symbol lookups:
+
+```bash
+npx -y obyte-mcp --network testnet --token-registry YOUR_TESTNET_REGISTRY_AA
+```
+
+## Tool Behavior
+
+All tool responses are JSON text envelopes.
+
+Success:
+
+```json
+{
+  "ok": true,
+  "meta": {
+    "network": "mainnet",
+    "hub": "https://obyte.org/api",
+    "tool": "obyte_get_balances",
+    "request_id": "...",
+    "duration_ms": 123,
+    "retry_count": 0,
+    "truncated": false
+  },
+  "data": {}
+}
+```
+
+Error:
+
+```json
+{
+  "ok": false,
+  "meta": {
+    "network": "mainnet",
+    "hub": "https://obyte.org/api",
+    "tool": "obyte_get_balances",
+    "request_id": "...",
+    "duration_ms": 123,
+    "retry_count": 0,
+    "truncated": false
+  },
+  "error": {
+    "code": "HUB_ERROR",
+    "message": "...",
+    "details": {}
+  }
+}
+```
+
+Error codes:
+
+- `VALIDATION_ERROR`
+- `CONFIG_ERROR`
+- `HUB_ERROR`
+- `TIMEOUT`
+- `NETWORK_ERROR`
+- `OUTPUT_TOO_LARGE`
+- `SECRET_INPUT_REJECTED`
+- `INTERNAL_ERROR`
+
+## Input Limits
+
+- Address arrays: max `20`
+- Oracle arrays: max `10`
+- State var prefix: max `128` characters
+- Generic JSON payloads: max `64KB`
+- All object schemas are strict and reject unknown fields
+
+## Output Limits And Truncation
+
+The server measures serialized UTF-8 output bytes. If output exceeds `OBYTE_MAX_OUTPUT_BYTES`, it truncates only `data`, never `meta` or `error`.
+
+Strategy:
+
+- Arrays keep the first items that fit and append `{ "__truncated__": true, "omitted_items": N }`.
+- Objects keep keys until the limit and add `__truncated_keys__`.
+- Strings are cut at a UTF-8 safe boundary and end with `...[truncated]`.
+- Map-like outputs such as AA state vars and balance maps are sorted by key before returning.
+- If safe truncation cannot fit the envelope, the server returns `OUTPUT_TOO_LARGE`.
+
+Truncation metadata:
+
+- `meta.truncated`
+- `meta.output_bytes_before_truncation`
+- `meta.output_bytes_after_truncation`
+- `meta.truncation_reason`
+
+## Retry Policy
+
+The server retries only pure read tools.
+
+Default:
+
+- Max attempts: `2`
+- Backoff with jitter: about `250ms`, then `750ms`
+- Retryable: transient network errors, timeout, HTTP `408`, `429`, `5xx`
+- Not retryable: validation errors, hub logical errors, most `4xx`, secret guard failures
+- Dry-run tools are not retried by default
+
+## Witnesses Cache
+
+Witnesses are cached:
+
+- In memory only
+- Per process
+- Per `network + hub`
+- TTL: `10 minutes`
+
+`obyte_get_witnesses` accepts `update=true` to force refresh. `obyte_get_history` uses cached witnesses unless explicit witnesses are passed or `update_witnesses=true`.
+
+## Tool Annotations
+
+All tools include MCP annotations:
+
+- `title`
+- `readOnlyHint: true`
+- `destructiveHint: false`
+- `openWorldHint: true`
+
+Pure reads also include:
+
+- `idempotentHint: true`
+
+Dry-run tools are not marked idempotent.
+
+## Security Notes
+
+### Secret Guard
+
+The server rejects inputs with secret-like field names or obvious private-key/mnemonic patterns:
+
+- `private_key`
+- `privkey`
+- `seed`
+- `mnemonic`
+- `xprv`
+- `passphrase`
+- `secret`
+
+String scanning is conservative. False positives are possible. If a public value is rejected, remove secret-like material or rename the field before calling the tool. This server never needs secrets.
+
+### Prompt Injection
+
+Ledger data, AA state vars, token descriptions, symbols, profile data, and hub responses are untrusted external content. Agents must treat them as data, not instructions.
+
+### Symbol Registry Trust Model
+
+Token registry mappings are convenience metadata, not proof that an asset is legitimate. Custom registries are explicitly user-trusted inputs. Symbols are not globally unique outside the selected registry.
+
+## Diagnostics
+
+During MCP stdio runtime, stdout is reserved for JSON-RPC protocol messages only.
+
+Diagnostics are written to stderr as JSON Lines:
+
+```json
+{"ts":"2026-07-07T12:00:00.000Z","package":"obyte-mcp","level":"error","event":"mcp_stdio_error","message":"..."}
+```
+
+Fields:
+
+- `ts`
+- `package`
+- `level`
+- `event`
+- `request_id`
+- `tool`
+- `message`
+- `details`
+
+`setup`, `doctor`, `--help`, and `--version` do not start MCP stdio and can write normal output to stdout.
+
+## Resources
+
+The server exposes:
+
+- `obyte://docs/overview`
+- `obyte://docs/autonomous-agents`
+- `obyte://docs/tools`
+- `obyte://config/current`
+- `obyte://examples/common-tasks`
+- `obyte://security/trust-model`
+
+## Prompts
+
+The server exposes:
+
+- `analyze_obyte_address`
+- `inspect_obyte_unit`
+- `debug_aa_response`
+- `resolve_obyte_asset`
+- `plan_aa_dry_run`
+- `summarize_portfolio`
+
+## Common AI Tasks
+
+Ask your MCP client:
+
+- "Check this Obyte address balances and explain the assets."
+- "Resolve this asset id to symbol and decimals."
+- "Inspect why this AA trigger failed."
+- "Dry-run this AA trigger on testnet."
+- "Summarize AA state vars with this prefix."
+- "Analyze this unit and follow the AA response chain."
+
+## MCP Inspector
+
+Run against the published package:
+
+```bash
+npx -y @modelcontextprotocol/inspector npx -y obyte-mcp --network mainnet
+```
+
+Run against a local build:
+
+```bash
+npm install
+npm run build
+npx -y @modelcontextprotocol/inspector node dist/index.js --network mainnet
+```
+
+## Local Development
+
+```bash
+git clone https://github.com/Taump/obyte-mcp.git
+cd obyte-mcp
+npm install
+npm run typecheck
+npm test
+npm run build
+node dist/index.js --help
+```
+
+Project structure:
+
+- `src/index.ts`: CLI entrypoint
+- `src/server.ts`: stdio MCP runtime
+- `src/obyteClient.ts`: Obyte hub HTTP client
+- `src/tools.ts`: MCP tool registration
+- `src/resources.ts`: MCP resources
+- `src/prompts.ts`: MCP prompts
+- `src/symbols.ts`: symbol/asset helpers
+- `src/config.ts`: runtime config and URL policy
+
+## Compatibility Matrix
+
+| Component | Status |
+| --- | --- |
+| Node.js | `>=20` |
+| MCP SDK | `@modelcontextprotocol/server@^2.0.0-beta.2` |
+| Transport | Local stdio only |
+| Codex | Local stdio MCP, version-tested note to be updated per release |
+| Claude Desktop | Local stdio MCP, version-tested note to be updated per release |
+| Claude Code | Local stdio MCP, version-tested note to be updated per release |
+| macOS | Supported |
+| Linux | Supported |
+| Windows | Supported when Node/npx are available in the client environment |
+| Obyte mainnet | Supported |
+| Obyte testnet | Supported |
+| Custom hub | HTTPS only, plus localhost HTTP for development |
+
+## Release Checklist
+
+Before publishing:
+
+```bash
+npm run typecheck
+npm test
+npm run build
+npm pack --dry-run
+npx -y ./obyte-mcp-*.tgz --help
+```
+
+Also:
+
+- Test the packed tarball with MCP Inspector.
+- Test Codex config.
+- Test Claude Desktop config.
+- Test Claude Code command with the required `--`.
+- Update version-tested notes in this README.
+- Verify README examples match actual CLI output.
+- Publish with npm provenance if available.
+- Create a GitHub release with changelog and compatibility notes.
+

package/dist/cliArgs.d.ts

@@ -0,0 +1,15 @@
+import type { CliOptions } from "./types.js";
+export type CommandName = "server" | "setup" | "doctor" | "help" | "version";
+export type ClientName = "codex" | "claude-desktop" | "claude-code";
+export interface ParsedCli {
+    command: CommandName;
+    options: CliOptions;
+    setup: {
+        printOnly: boolean;
+        client?: ClientName;
+    };
+    doctor: {
+        json: boolean;
+    };
+}
+export declare function parseCliArgs(argv: string[]): ParsedCli;

package/dist/cliArgs.js

@@ -0,0 +1,97 @@
+import { ObyteMcpError } from "./errors.js";
+import { parseNetwork } from "./config.js";
+export function parseCliArgs(argv) {
+    const parsed = {
+        command: "server",
+        options: {},
+        setup: { printOnly: false },
+        doctor: { json: false }
+    };
+    const args = [...argv];
+    const first = args[0];
+    if (first === "setup" || first === "doctor") {
+        parsed.command = first;
+        args.shift();
+    }
+    else if (first === "--help" || first === "-h" || first === "help") {
+        parsed.command = "help";
+        args.shift();
+    }
+    else if (first === "--version" || first === "-v" || first === "version") {
+        parsed.command = "version";
+        args.shift();
+    }
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg)
+            continue;
+        if (arg === "--print-only") {
+            parsed.setup.printOnly = true;
+            continue;
+        }
+        if (arg === "--json") {
+            parsed.doctor.json = true;
+            continue;
+        }
+        const next = args[index + 1];
+        if (arg === "--network") {
+            parsed.options.network = requireValue(parseNetwork(next, "--network"), "--network");
+            index += 1;
+            continue;
+        }
+        if (arg === "--hub") {
+            parsed.options.hubAddress = requireString(next, "--hub");
+            index += 1;
+            continue;
+        }
+        if (arg === "--token-registry") {
+            parsed.options.tokenRegistryAddress = requireString(next, "--token-registry");
+            index += 1;
+            continue;
+        }
+        if (arg === "--timeout-ms") {
+            parsed.options.timeoutMs = parseInteger(requireString(next, "--timeout-ms"), "--timeout-ms");
+            index += 1;
+            continue;
+        }
+        if (arg === "--max-concurrency") {
+            parsed.options.maxConcurrency = parseInteger(requireString(next, "--max-concurrency"), "--max-concurrency");
+            index += 1;
+            continue;
+        }
+        if (arg === "--max-output-bytes") {
+            parsed.options.maxOutputBytes = parseInteger(requireString(next, "--max-output-bytes"), "--max-output-bytes");
+            index += 1;
+            continue;
+        }
+        if (arg === "--client") {
+            parsed.setup.client = parseClient(requireString(next, "--client"));
+            index += 1;
+            continue;
+        }
+        throw new ObyteMcpError("CONFIG_ERROR", `Unknown argument: ${arg}`);
+    }
+    return parsed;
+}
+function requireValue(value, label) {
+    if (value === undefined)
+        throw new ObyteMcpError("CONFIG_ERROR", `${label} requires a value`);
+    return value;
+}
+function requireString(value, label) {
+    if (!value || value.startsWith("--"))
+        throw new ObyteMcpError("CONFIG_ERROR", `${label} requires a value`);
+    return value;
+}
+function parseInteger(value, label) {
+    const number = Number(value);
+    if (!Number.isInteger(number))
+        throw new ObyteMcpError("CONFIG_ERROR", `${label} requires an integer`);
+    return number;
+}
+function parseClient(value) {
+    if (value === "codex" || value === "claude-desktop" || value === "claude-code")
+        return value;
+    throw new ObyteMcpError("CONFIG_ERROR", "--client must be codex, claude-desktop, or claude-code", { value });
+}
+//# sourceMappingURL=cliArgs.js.map

package/dist/cliArgs.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { CliOptions, Network, RuntimeConfig } from "./types.js";
+export declare function parseNetwork(value: string | undefined, source: string): Network | undefined;
+export declare function buildRuntimeConfig(env?: NodeJS.ProcessEnv, cli?: CliOptions): RuntimeConfig;
+export declare function normalizeHubAddress(value: string | undefined): string | undefined;