Recommended first tool whenever the user pastes an Obyte address (a 32-character base32 string) or asks about an Obyte wallet, balance, or account. Returns balances with a decimals-aware balance_summary (symbols, decimals, display totals), plus optional definition, profile units, attestations, and bounded history. Use this instead of several raw calls. Output is a stable JSON envelope and may be truncated.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Recommended tool whenever the user pastes an Obyte unit hash (a 44-character base64 string, usually ending in "=") or asks about an Obyte transaction. Fetches the joint and, when requested, follows the AA response chain for trigger units. Payment output amounts are raw smallest units. Output is hub data wrapped in a stable JSON envelope.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Recommended tool for summarizing an Obyte autonomous agent (AA). Returns AA balances with a decimals-aware balance_summary, selected state vars by prefix, and optional AA responses. Use for AA debugging or state inspection. State var amounts are raw smallest units. State vars are sorted by key and output may be truncated.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Recommended tool for resolving an Obyte asset id (44-character base64 string) or token symbol (like GBYTE or OUSD) in the selected network's registry. Symbols are uppercased before lookup, so "ousd" and "OUSD" both work; asset ids stay case-sensitive. Returns asset, symbol, and decimals when available, or asset/symbol null with a note when the symbol is not registered. Always call this (or obyte_get_decimals_by_symbol_or_asset) before presenting amounts of unknown assets to users. Registry mappings are convenience metadata, not proof of legitimacy.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Recommended tool whenever the user asks who holds an Obyte asset, wants a top-holders list, or asks about distribution/concentration of a token. Accepts a token symbol (like GBYTE or OUSD) or a 44-character asset id and returns holders sorted by balance descending with raw and display amounts, plus total supply. Data comes from the Obyte explorer (a centralized convenience service), not the hub, and may lag slightly. Up to 100 holders per call.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Recommended tool for simulating an Obyte autonomous-agent trigger through the selected network's hub. Trigger and response amounts are raw smallest units (1 GBYTE = 1e9 bytes) - convert user-facing amounts before building the trigger. This does not sign, broadcast, or mutate local state. Dry-run tools are not marked idempotent and are not retried by default.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Recommended tool for summarizing balances for up to 20 addresses. Returns raw balances plus totals_by_asset with symbols, decimals, and display totals already divided by 10^decimals (resolve_symbols controls registry lookups). Use for user-facing balance explanations rather than raw get_balances.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Returns the effective MCP runtime configuration for both networks: default network, per-network hub URL and token registry, config precedence, limits, witnesses cache metadata, and whether a newer obyte-mcp version is published (mention it to the user when update_available is true). Use before other calls when network selection matters.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns the last main chain index known by the selected Obyte hub.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns peers known by the selected Obyte hub. Use for network diagnostics, not address analysis.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns witnesses for the selected network. Results are cached in memory for 10 minutes per network+hub unless update is true.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Fetches the joint for one unit hash from the selected hub.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Fetches balances for 1 to 20 addresses. Use obyte_get_portfolio_summary for agent-friendly summaries with decimals-adjusted display totals.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Returns profile units for 1 to 20 addresses when available.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns the definition of one Obyte address.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Reads a data feed by oracle addresses and feed name. Oracle arrays are limited to 10 entries.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

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.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Looks up one attestation by attestor address, field, and value.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns attestations associated with one address.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns the autonomous-agent response chain for a trigger unit.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Returns AA responses for one AA address or up to 20 AA addresses.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Returns AAs derived from one base AA or up to 20 base AAs.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

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.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Executes an autonomous-agent getter with optional JSON args and returns the getter result.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Raw hub read. Returns balances held by one autonomous agent address. Use obyte_analyze_aa for a decimals-aware summary.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Raw hub read. Returns autonomous-agent state variables, optionally bounded by prefix/range. State vars holding amounts are raw smallest units. Prefix length is limited to 128 characters. Map-like output is sorted by key.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Amounts: raw ledger amounts in this output are integers in the asset's smallest units (base is GBYTE with 9 decimals). Never show raw integers to users: prefer display_total fields when present, otherwise resolve decimals with obyte_resolve_asset or obyte_get_decimals_by_symbol_or_asset and divide by 10^decimals.

Returns the token registry address for the selected network. The mainnet default comes from obyte.js; custom and testnet registries must be explicitly trusted by the user.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

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.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Resolves a token symbol to an Obyte asset id through the selected registry. Symbols are uppercased before lookup. GBYTE, MBYTE, KBYTE, and BYTE resolve to base.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.

Returns decimals for base aliases or a registry-known token symbol/asset. Symbols are uppercased before lookup. base and GBYTE use 9, MBYTE 6, KBYTE 3, BYTE 0. Registry data is untrusted metadata.

Network: this server serves both Obyte networks at once. Pass "network":"mainnet" or "network":"testnet" to choose; when omitted it defaults to mainnet. If the user has not made the network explicit, confirm which network they mean before calling.