# Obyte MCP (npm · obyte-mcp)

Query Obyte mainnet and testnet: balances, units, autonomous agents, AA state, dry runs, tokens.

- Trust score: 78/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- npm · `obyte-mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp.md), [page](https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp)

## Channel facts

- Registry: `npm`
- Package: `obyte-mcp`
- Version: `0.3.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 3 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 29 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5336 tokens (~148/item across 36 items; 30 tools + 6 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "obyte_execute_getter" implies "execute" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 32 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Obyte MCP server?

Obyte MCP runs locally as an npm package, launched with npx -y obyte-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add taump-obyte-mcp -- npx -y obyte-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "taump-obyte-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obyte-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "taump-obyte-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obyte-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add taump-obyte-mcp -- npx -y obyte-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "taump-obyte-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "obyte-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add taump-obyte-mcp --command npx --arg -y --arg obyte-mcp
```

### Hermes

```yaml
mcp_servers:
  taump-obyte-mcp:
    command: "npx"
    args: ["-y", "obyte-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "taump-obyte-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "obyte-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add taump-obyte-mcp -t stdio -c npx -a -y obyte-mcp
```

### Other

```json
{
  "mcpServers": {
    "taump-obyte-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obyte-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 78, +1)

- [security] Stability: 0.97 → pass

### 2026-09-18 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-14 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-12 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 70 to 73. That category is still filling its 30-day observation window: 21 days of observed history at the previous scan, 22 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-10 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-07 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-05 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (30)

### `obyte_analyze_address` (~257 tokens)

Analyze Obyte Address

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.

Input parameters:

- `address` (string, required)
- `include_attestations` (boolean)
- `include_definition` (boolean)
- `include_history` (boolean)
- `network` (string)

### `obyte_analyze_unit` (~230 tokens)

Analyze Obyte Unit

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.

Input parameters:

- `include_aa_response_chain` (boolean)
- `network` (string)
- `unit` (string, required)

### `obyte_analyze_aa` (~238 tokens)

Analyze Autonomous Agent

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.

Input parameters:

- `address` (string, required)
- `include_balances` (boolean)
- `include_responses` (boolean)
- `network` (string)
- `state_var_prefix` (string)

### `obyte_resolve_asset` (~210 tokens)

Resolve Obyte Asset

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.

Input parameters:

- `network` (string)
- `token_registry_address` (string)
- `value` (string, required)

### `obyte_get_asset_holders` (~255 tokens)

Get Asset Holders

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.

Input parameters:

- `asset_or_symbol` (string, required)
- `limit` (integer)
- `network` (string)

### `obyte_prepare_aa_dry_run` (~232 tokens)

Prepare AA Dry Run

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.

Input parameters:

- `address` (string, required)
- `network` (string)
- `trigger` (required)

### `obyte_get_portfolio_summary` (~223 tokens)

Get Portfolio Summary

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.

Input parameters:

- `addresses` (array, required)
- `network` (string)
- `resolve_symbols` (boolean)
- `token_registry_address` (string)

### `obyte_get_network_info` (~135 tokens)

Get Obyte Network Info

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.

Input parameters:

- `network` (string)

### `obyte_get_last_mci` (~92 tokens)

Get Last MCI

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.

Input parameters:

- `network` (string)

### `obyte_get_peers` (~96 tokens)

Get Hub Peers

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.

Input parameters:

- `network` (string)

### `obyte_get_witnesses` (~110 tokens)

Get Witnesses

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.

Input parameters:

- `network` (string)
- `update` (boolean)

### `obyte_get_joint` (~96 tokens)

Get Joint

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.

Input parameters:

- `network` (string)
- `unit` (string, required)

### `obyte_get_balances` (~181 tokens)

Get Balances

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.

Input parameters:

- `addresses` (array, required)
- `network` (string)

### `obyte_get_profile_units` (~97 tokens)

Get Profile Units

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.

Input parameters:

- `addresses` (array, required)
- `network` (string)

### `obyte_get_definition` (~92 tokens)

Get Address Definition

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.

Input parameters:

- `address` (string, required)
- `network` (string)

### `obyte_get_data_feed` (~126 tokens)

Get Data Feed

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.

Input parameters:

- `feed_name` (string, required)
- `ifnone` (string|number|boolean|null)
- `network` (string)
- `oracles` (array, required)

### `obyte_get_history` (~200 tokens)

Get Address History

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.

Input parameters:

- `addresses` (array, required)
- `network` (string)
- `update_witnesses` (boolean)
- `witnesses` (array)

### `obyte_get_attestation` (~115 tokens)

Get Attestation

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.

Input parameters:

- `attestor_address` (string, required)
- `field` (string, required)
- `network` (string)
- `value` (string, required)

### `obyte_get_attestations` (~93 tokens)

Get Address Attestations

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.

Input parameters:

- `address` (string, required)
- `network` (string)

### `obyte_get_aa_response_chain` (~166 tokens)

Get AA Response Chain

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.

Input parameters:

- `network` (string)
- `trigger_unit` (string, required)

### `obyte_get_aa_responses` (~176 tokens)

Get AA Responses

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.

Input parameters:

- `aa` (string)
- `aas` (array)
- `network` (string)

### `obyte_get_aas_by_base_aas` (~116 tokens)

Get AAs By Base AAs

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.

Input parameters:

- `base_aa` (string)
- `base_aas` (array)
- `network` (string)

### `obyte_dry_run_aa` (~191 tokens)

Dry Run AA

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.

Input parameters:

- `address` (string, required)
- `network` (string)
- `trigger` (required)

### `obyte_execute_getter` (~111 tokens)

Execute AA Getter

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.

Input parameters:

- `address` (string, required)
- `args`
- `getter` (string, required)
- `network` (string)

### `obyte_get_aa_balances` (~176 tokens)

Get AA Balances

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.

Input parameters:

- `address` (string, required)
- `network` (string)

### `obyte_get_aa_state_vars` (~219 tokens)

Get AA State Vars

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.

Input parameters:

- `address` (string, required)
- `network` (string)
- `var_prefix` (string)
- `var_prefix_from` (string)
- `var_prefix_to` (string)

### `obyte_get_official_token_registry_address` (~119 tokens)

Get Token Registry Address

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.

Input parameters:

- `network` (string)
- `token_registry_address` (string)

### `obyte_get_symbol_by_asset` (~127 tokens)

Get Symbol By Asset

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.

Input parameters:

- `asset` (required)
- `network` (string)
- `token_registry_address` (string)

### `obyte_get_asset_by_symbol` (~129 tokens)

Get Asset By Symbol

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.

Input parameters:

- `network` (string)
- `symbol` (string, required)
- `token_registry_address` (string)

### `obyte_get_decimals_by_symbol_or_asset` (~146 tokens)

Get Decimals By Symbol Or Asset

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.

Input parameters:

- `network` (string)
- `symbol_or_asset` (string, required)
- `token_registry_address` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp#diagnostics

## Score history

- 2026-09-20: 78
- 2026-09-19: 77
- 2026-09-18: 77
- 2026-09-17: 76
- 2026-09-16: 76
- 2026-09-15: 75
- 2026-09-14: 75
- 2026-09-13: 74
- 2026-09-12: 74
- 2026-09-11: 73
- 2026-09-10: 73
- 2026-09-09: 72
- 2026-09-08: 72
- 2026-09-07: 72
- 2026-09-06: 71
- 2026-09-05: 71
- 2026-09-04: 70
- 2026-09-03: 70
- 2026-09-02: 69
- 2026-09-01: 69
- 2026-08-31: 68
- 2026-08-30: 68
- 2026-08-29: 68
- 2026-08-28: 65
- 2026-08-27: 65
- 2026-08-26: 65
- 2026-08-25: 63
- 2026-08-24: 63
- 2026-08-23: 63
- 2026-08-22: 63

## Common questions

### What is the Obyte MCP server?

Obyte MCP is listed in the public MCP registry as io.github.Taump/obyte-mcp. Query Obyte mainnet and testnet: balances, units, autonomous agents, AA state, dry runs, tokens. This page covers its npm package (obyte-mcp).

### Is the Obyte MCP server safe to use?

Obyte MCP scores 78 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Obyte MCP server expose?

Obyte MCP exposes 30 tools: obyte_analyze_address, obyte_analyze_unit, obyte_analyze_aa, obyte_resolve_asset, obyte_get_asset_holders, and 25 more. Their descriptions and schemas cost roughly 4,754 tokens of context every time the server is loaded.

### Is the Obyte MCP server still maintained?

Obyte MCP is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Obyte MCP server under?

Obyte MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/obyte-mcp
- Socket report: https://socket.dev/npm/package/obyte-mcp
- Repository: https://github.com/Taump/obyte-mcp
- Changelog RSS feed: https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp.json
- HTML version of this page: https://verifymcp.io/servers/taump-obyte-mcp/obyte-mcp