Skip to content

Asteroid XRPL Hub

by asteroidxrpl.com · remote · no sign-in to list tools · v0.4.0 · published by com.asteroidxrpl

Read-only XRPL tools for ASTEROID: identity, market, supply, liquidity, escrows, holders, AMM quotes

Changes · 1

15 tools: 1 change things and 14 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http asteroid-xrpl-hub https://asteroidxrpl.com/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "verify_liquidity_lock" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true}; The name "verify_liquidity_lock" says "lock": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

15 tools

Changes things 1Claude Code: ask
  • verify_liquidity_lockLive verification of every project-declared LP-holding account for the ASTEROID/XRP AMM: LP balance, share of LP supply, pro-rata implied XRP and ASTEROID, and a per-account contro…1 finding

    Why it is in this group

    • The name "verify_liquidity_lock" says "lock": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "verify_liquidity_lock" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true}; The name "verify_liquidity_lock" says "lock": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Live verification of every project-declared LP-holding account for the ASTEROID/XRP AMM: LP balance, share of LP supply, pro-rata implied XRP and ASTEROID, and a per-account control assessment derived from the master key, regular key and signer list at a validated ledger, plus an overall verdict. A closed signing path is an observation at one ledger, not a permanence guarantee, and the role of each account is an owner-confirmed project declaration.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
Only reads 14Claude Code: allow
  • discover_assetReturns the authoritative ASTEROID XRPL entry points, the full capability catalogue with an explicit state for every callable tool (available, legacy-available, deprecated, unavail…No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Returns the authoritative ASTEROID XRPL entry points, the full capability catalogue with an explicit state for every callable tool (available, legacy-available, deprecated, unavailable or planned) including its freshness, provenance, schema and limitations, the schema version and the exact canonical asset identity.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • get_asset_identityReturns the immutable canonical ASTEROID identity (network, issuer, exact 160-bit currency code, canonical token identifier) plus claim-status-separated project metadata.No findings

    Why it is in this group

    • The name "get_asset_identity" says "get": a word for reading.
    Description, as the server wrote it
    Returns the immutable canonical ASTEROID identity (network, issuer, exact 160-bit currency code, canonical token identifier) plus claim-status-separated project metadata. No changing ledger metrics.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • get_escrow_scheduleLedger-indexed schedule of the project-declared treasury ASTEROID escrows: every escrow object with its exact amount, destination, finish-after and cancel-after times and a locked/…No findings

    Why it is in this group

    • The name "get_escrow_schedule" says "get": a word for reading.
    Description, as the server wrote it
    Ledger-indexed schedule of the project-declared treasury ASTEROID escrows: every escrow object with its exact amount, destination, finish-after and cancel-after times and a locked/releasable/expired state, plus the total escrowed amount and the next unlock. The escrow objects are ledger-verified; the treasury role of the account is an owner-confirmed declaration, and an escrow does not establish who controls the destination after release.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_escrow_statsDeprecated — use get_escrow_schedule, which is enveloped and adds per-escrow locked/releasable/expired state.No findings

    Why it is in this group

    • The name "get_escrow_stats" says "get": a word for reading.
    Description, as the server wrote it
    Deprecated — use get_escrow_schedule, which is enveloped and adds per-escrow locked/releasable/expired state. Time-locked project-declared treasury ASTEROID escrows on the XRP Ledger: every escrow with its amount, finish-after (unlock) date, cancel-after date, plus the total escrowed amount and its share of supply. The treasury role is an owner-confirmed declaration; the escrow objects themselves are ledger-readable. Escrow existence does not establish who controls the destination account after release.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • get_holder_distributionComplete trust-line enumeration of the ASTEROID issuer on one validated ledger: total trust lines, trust lines with a non-zero balance, whether the marker chain was exhausted, and …No findings

    Why it is in this group

    • The name "get_holder_distribution" says "get": a word for reading.
    Description, as the server wrote it
    Complete trust-line enumeration of the ASTEROID issuer on one validated ledger: total trust lines, trust lines with a non-zero balance, whether the marker chain was exhausted, and the exact counting methodology. A trust line is not a person: one holder may control many accounts and custodial accounts may aggregate many holders.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_liquidity_stateLedger-indexed ASTEROID/XRP AMM state: pooled XRP and ASTEROID, LP token supply, the XRPL AMM trading fee (a protocol pool fee set by LP votes, not a token tax), and each declared …No findings

    Why it is in this group

    • The name "get_liquidity_state" says "get": a word for reading.
    Description, as the server wrote it
    Ledger-indexed ASTEROID/XRP AMM state: pooled XRP and ASTEROID, LP token supply, the XRPL AMM trading fee (a protocol pool fee set by LP votes, not a token tax), and each declared LP-holding account with its LP share, pro-rata implied reserves and a live accessibility verdict derived from the account's master key, regular key and signer list. Not a quote.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_liquidity_statsDeprecated — use get_liquidity_state, which is enveloped and assesses LP accessibility live from account control paths.No findings

    Why it is in this group

    • The name "get_liquidity_stats" says "get": a word for reading.
    Description, as the server wrote it
    Deprecated — use get_liquidity_state, which is enveloped and assesses LP accessibility live from account control paths. Current ASTEROID/XRP AMM pool data: pooled XRP and ASTEROID, LP token supply, the XRPL AMM trading fee as `tradingFeeUnits` (raw XRPL TradingFee, in units of 1/100,000 — 502 units = 0.502% = 50.2 basis points) with `tradingFeePct` giving the same fee as a percentage (the legacy `tradingFeeBps` field is misnamed and carries the same raw units, not basis points), and the split between LP tokens held by project-declared locked accounts and the rest of the community. The XRPL AMM trading fee is a protocol pool fee set by LP votes — it is not a token tax and can change at any time. This is not a quote and must not be used to price a swap.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • get_market_stateComposite, ledger-indexed snapshot of ASTEROID: supply (outstanding, escrowed, total, circulating), AMM liquidity and trading fee, LP-lock accessibility assessed from live control …No findings

    Why it is in this group

    • The name "get_market_state" says "get": a word for reading.
    Description, as the server wrote it
    Composite, ledger-indexed snapshot of ASTEROID: supply (outstanding, escrowed, total, circulating), AMM liquidity and trading fee, LP-lock accessibility assessed from live control paths, project-declared treasury escrows, and trust-line/holder counts. Enveloped with per-section provenance and degraded codes. Observation of ledger state only — not a quote, not a market evaluation and not transaction preparation.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_price_historyLegacy-available.No findings

    Why it is in this group

    • The name "get_price_history" says "get": a word for reading.
    Description, as the server wrote it
    Legacy-available. Daily USD price observations for ASTEROID over the last 30 days, plus the current USD price and the 24h and 30d percentage change. Independently sourced from a third-party market API, not a ledger read. Indicative only — not a quote, not executable, and no slippage or depth is modelled.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • get_project_infoLegacy-available.No findings

    Why it is in this group

    • The name "get_project_info" says "get": a word for reading.
    Description, as the server wrote it
    Legacy-available. Static public reference info about the ASTEROID XRPL project: issuer address, currency code, declared wallet roles with their claim status, website, where to buy, official social links and the risk disclaimer. For canonical machine identity prefer get_asset_identity.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false
  • get_supply_stateLedger-indexed ASTEROID supply: outstanding tokens on trust lines, escrowed tokens on the project-declared treasury, total supply, circulating supply and the original issuance reva…No findings

    Why it is in this group

    • The name "get_supply_state" says "get": a word for reading.
    Description, as the server wrote it
    Ledger-indexed ASTEROID supply: outstanding tokens on trust lines, escrowed tokens on the project-declared treasury, total supply, circulating supply and the original issuance revalidated against its anchor transaction. Amounts are exact decimal strings. Unreadable values are null with a degraded code and are never returned as zero.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_swap_quoteIndicative bidirectional estimate against the live ASTEROID/XRP AMM pool, in either direction and for an exact input or an exact output.No findings

    Why it is in this group

    • The name "get_swap_quote" says "get": a word for reading.
    Description, as the server wrote it
    Indicative bidirectional estimate against the live ASTEROID/XRP AMM pool, in either direction and for an exact input or an exact output. Returns the amount in and out, the pool fee taken, spot and effective price, price impact, pool utilisation and optional slippage bounds, all as exact decimal strings at a stated validated ledger index. INDICATIVE ONLY: it is not executable, it models only the single AMM pool (no order books, no path-finding, no network or transfer fees), and this service never signs, submits or prepares a transaction and never accepts a key.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: false
    • openWorldHint: true
  • get_token_statsDeprecated — use get_supply_state, which is enveloped with a validated ledger index, per-value claim statuses, exact decimal strings and degraded codes.No findings

    Why it is in this group

    • The name "get_token_stats" says "get": a word for reading.
    Description, as the server wrote it
    Deprecated — use get_supply_state, which is enveloped with a validated ledger index, per-value claim statuses, exact decimal strings and degraded codes. Current on-chain stats for the ASTEROID token on the XRP Ledger: total supply (including escrowed tokens), holder count, issuer XRP balance, and the balance and supply share of the project-declared takeover qualifying wallet. Wallet labels describe owner-confirmed declared roles only.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: true
  • verify_assetCompares a candidate network, issuer and currency code against the canonical ASTEROID identity and returns a field-by-field result.No findings

    Why it is in this group

    • The description's first verb is "compare": a word for reading.
    Description, as the server wrote it
    Compares a candidate network, issuer and currency code against the canonical ASTEROID identity and returns a field-by-field result. The display symbol ASTEROID alone is never sufficient verification.

    Annotations the server declares

    • readOnlyHint: true
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.4.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http asteroid-xrpl-hub https://asteroidxrpl.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__asteroid-xrpl-hub__discover_asset",
      "mcp__asteroid-xrpl-hub__get_asset_identity",
      "mcp__asteroid-xrpl-hub__verify_asset",
      "mcp__asteroid-xrpl-hub__get_market_state",
      "mcp__asteroid-xrpl-hub__get_supply_state",
      "mcp__asteroid-xrpl-hub__get_liquidity_state",
      "mcp__asteroid-xrpl-hub__get_escrow_schedule",
      "mcp__asteroid-xrpl-hub__get_holder_distribution",
      "mcp__asteroid-xrpl-hub__get_swap_quote",
      "mcp__asteroid-xrpl-hub__get_project_info",
      "mcp__asteroid-xrpl-hub__get_token_stats",
      "mcp__asteroid-xrpl-hub__get_liquidity_stats",
      "mcp__asteroid-xrpl-hub__get_escrow_stats",
      "mcp__asteroid-xrpl-hub__get_price_history"
    ],
    "ask": [
      "mcp__asteroid-xrpl-hub__verify_liquidity_lock"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as asteroid-xrpl-hub. Review it before you use it.