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
15 tools: 1 change things and 14 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads14Claude Code: allow: see these tools
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/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "verify_liquidity_lock" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true}; The name "verify_liquidity_lock" says "lock": a word for a change.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":false,"openWorldHint":true}; The name "verify_liquidity_lock" says "lock": a word for a change.
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/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .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.