DOCS/MCP/TOOLS

MCP Tools Reference

Complete reference for all 38 tools available through the MCP Gateway.

get_networks

Get all available networks (mainnet, testnet, PBaaS chains)

PARAMETERS

get_block

Get block details by height or hash

PARAMETERS
chainIdrequired
string — Chain ID
heightOrHashrequired
string — Block height or hash

get_recent_blocks

Get the most recent blocks

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Number of blocks (default 10)

get_block_transactions

Get all transactions in a specific block

PARAMETERS
chainIdrequired
string — Chain ID
heightrequired
number — Block height
limit
number — Max transactions (default 100)

get_transaction

Get transaction details by txid

PARAMETERS
chainIdrequired
string — Chain ID
txidrequired
string — Transaction ID

get_identity

Get VerusID by name or i-address

PARAMETERS
chainIdrequired
string — Chain ID
nameOrAddressrequired
string — Identity name or i-address

search_identities

Search for VerusIDs by name pattern

PARAMETERS
chainIdrequired
string — Chain ID
queryrequired
string — Search pattern
limit
number — Max results (default 20)

get_identity_history

Get all revisions of a VerusID

PARAMETERS
chainIdrequired
string — Chain ID
identityAddressrequired
string — Identity i-address

get_new_identities

Get recently created identities

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Number of identities (default 20)

get_identity_by_address

Find identity that owns a given primary address

PARAMETERS
chainIdrequired
string — Chain ID
primaryAddressrequired
string — R-address to search

get_address_balance

Get all currency balances for an address

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — R-address or i-address

get_address_transactions

Get transaction history for an address

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — R-address or i-address
limit
number — Max results (default 20)

get_address_info

Get detailed info about an address (type, first seen, stats)

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — R-address or i-address

get_utxos

Get UTXOs (unspent outputs) for an address

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — R-address or i-address
currencyId
string — Filter by currency
includeSpent
boolean — Include spent UTXOs
limit
number — Max results (default 50)

compare_addresses

Compare balances between multiple addresses

PARAMETERS
chainIdrequired
string — Chain ID
addressesrequired
array — List of addresses (max 10)
currencyId
string — Currency to compare

get_currencies

List all currencies on a chain

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Max results (default 50)

search_currencies

Search for currencies by name

PARAMETERS
chainIdrequired
string — Chain ID
queryrequired
string — Search query
limit
number — Max results (default 20)

get_currency

Get currency definition by name or i-address

PARAMETERS
chainIdrequired
string — Chain ID
nameOrIdrequired
string — Currency name or i-address

get_currency_state

Get current state of a basket/reserve currency

PARAMETERS
chainIdrequired
string — Chain ID
currencyIdrequired
string — Currency i-address

get_currency_price_history

Get historical price data for a currency

PARAMETERS
chainIdrequired
string — Chain ID
currencyIdrequired
string — Currency i-address
limit
number — Data points (default 100)

get_rich_list

Get top holders for a currency

PARAMETERS
chainIdrequired
string — Chain ID
currencyId
string — Currency ID (defaults to native)
limit
number — Max results (default 20)

get_chain_stats

Get overall blockchain statistics

PARAMETERS
chainIdrequired
string — Chain ID

get_whale_movements

Get large transfers above a threshold

PARAMETERS
chainIdrequired
string — Chain ID
currencyId
string — Currency to track
minAmount
number — Min amount (default 10000)
limit
number — Max results (default 20)

get_active_addresses

Get addresses with recent activity

PARAMETERS
chainIdrequired
string — Chain ID
blocks
number — Recent blocks to check (default 100)
limit
number — Max results (default 50)

get_daily_stats

Get daily blockchain statistics

PARAMETERS
chainIdrequired
string — Chain ID
days
number — Number of days (default 7, max 30)

get_identities_with_currencies

Get identities that have defined currencies

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Max results (default 20)

get_identity_children

Get child/sub-identities of a parent

PARAMETERS
chainIdrequired
string — Chain ID
parentIdentityrequired
string — Parent identity name or i-address
limit
number — Max results (default 50)

get_revoked_identities

Get recently revoked identities

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Max results (default 20)

get_basket_currencies

Get basket/reserve currencies with liquidity pools

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Max results (default 20)

get_token_currencies

Get token currencies (non-basket, non-PBaaS)

PARAMETERS
chainIdrequired
string — Chain ID
limit
number — Max results (default 50)

get_pbaas_chains

Get all PBaaS chains

PARAMETERS
chainId
string — Parent chain (optional)

get_largest_transactions

Get largest transactions by value

PARAMETERS
chainIdrequired
string — Chain ID
currencyId
string — Filter by currency
limit
number — Max results (default 20)

validate_address

Validate address and get type/identity info

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — Address to validate

search_all

Unified search across identities, currencies, transactions

PARAMETERS
chainIdrequired
string — Chain ID
queryrequired
string — Search query

get_block_by_time

Find block closest to a timestamp

PARAMETERS
chainIdrequired
string — Chain ID
timestamprequired
string — ISO or Unix timestamp

get_address_first_activity

Get first transaction for an address

PARAMETERS
chainIdrequired
string — Chain ID
addressrequired
string — R-address or i-address

count_holders

Count holders for a currency

PARAMETERS
chainIdrequired
string — Chain ID
currencyId
string — Currency (defaults to native)
minBalance
number — Min balance to count (default 0)

Example Prompts

"What networks are available?"

Uses: get_networks

"Show me the VerusID named mike@"

Uses: get_identity

"What's the balance of RXL3YXG2..."

Uses: get_address_balance

"List the top 10 VRSC holders"

Uses: get_rich_list

"Show chain statistics for testnet"

Uses: get_chain_stats

"Get UTXOs for address R..."

Uses: get_utxos

"Search for currencies containing 'bridge'"

Uses: search_currencies

"Compare balances of these 3 addresses"

Uses: compare_addresses