Asteroid XRPL Hub

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

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "asteroid-xrpl-hub": {
      "url": "https://asteroidxrpl.com/mcp"
    }
  }
}

Remote endpoints

https://asteroidxrpl.com/mcpstreamable-http

What it can do

Tool inventory

Tools (15)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢discover_asset

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_asset_identity

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢verify_asset(network, issuer, currencyCode)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "description": "Network identifier to check, e.g. \"xrpl-mainnet\". Required for a match."
    },
    "issuer": {
      "type": "string",
      "description": "XRPL issuer address to check. Required for a match."
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code to check — the exact 160-bit hex code. Required for a match."
    }
  },
  "required": [
    "network",
    "issuer",
    "currencyCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_market_state

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_supply_state

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_liquidity_state

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢verify_liquidity_lock

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_escrow_schedule

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_holder_distribution

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_swap_quote(direction, side, amount, slippageTolerancePct)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "direction": {
      "type": "string",
      "enum": [
        "xrp-to-asteroid",
        "asteroid-to-xrp"
      ],
      "description": "Which asset is paid in and which is received."
    },
    "side": {
      "default": "exact-in",
      "description": "Whether `amount` is the exact input paid or the exact output required.",
      "type": "string",
      "enum": [
        "exact-in",
        "exact-out"
      ]
    },
    "amount": {
      "type": "string",
      "minLength": 1,
      "description": "Positive exact decimal string, in units of the asset implied by `side`."
    },
    "slippageTolerancePct": {
      "description": "Optional tolerance between 0 and 50, used only to derive a bound.",
      "type": "string"
    }
  },
  "required": [
    "direction",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_project_info

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_token_stats

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_liquidity_stats

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_escrow_stats

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_price_history

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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools