> ## Documentation Index
> Fetch the complete documentation index at: https://docs.range.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools Reference

> All 21 tools available in the Range MCP server, organized by category.

The Range MCP server exposes 21 tools across 4 categories. Every tool returns JSON and handles errors gracefully — your AI client receives a clear error message rather than an exception when something goes wrong.

**Endpoint:** `https://api.range.org/ai/mcp`
**Auth:** `Authorization: Bearer <api_key>`

***

## Risk & Sanctions

<AccordionGroup>
  <Accordion title="get_address_risk" icon="shield-halved">
    Get the risk score for a blockchain address. Returns a risk level (VERY\_LOW to CRITICAL), numeric score (1–10), reasoning, malicious addresses found in the transaction graph, and entity attribution.

    This is the recommended first call in any investigation.

    | Parameter | Type   | Required | Description                                                                                                                                                           |
    | --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `address` | string | Yes      | Blockchain address. EVM: `0x...` (42 chars). Solana: base58 (32–44 chars). Stellar: `G...` or `M...` (56 chars). Cosmos: network-prefixed bech32.                     |
    | `network` | string | No       | Network ID. Examples: `eth`, `solana`, `stellar`, `cosmoshub-4`, `osmosis-1`, `dydx-mainnet-1`, `neutron-1`, `tron`. Auto-detected for EVM/Solana/Stellar if omitted. |
  </Accordion>

  <Accordion title="get_transaction_risk" icon="triangle-exclamation">
    Get the risk score for a transaction by hash. Evaluates all addresses involved and returns the highest risk score found with per-address breakdown.

    | Parameter     | Type   | Required | Description                                                                                                 |
    | ------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------- |
    | `transaction` | string | Yes      | Transaction hash to assess.                                                                                 |
    | `network`     | string | No       | Network of the transaction. Examples: `solana`, `ethereum`, `cosmoshub-4`. Defaults to `solana` if omitted. |
  </Accordion>

  <Accordion title="get_payment_risk" icon="money-bill-transfer">
    Assess the risk of a cross-chain payment before it's sent. Analyzes sender/recipient risk, interaction history, address poisoning, malicious connections, and behavioral indicators. Returns `overall_risk_level` (LOW/MEDIUM/HIGH/UNKNOWN) with detailed risk factors.

    | Parameter           | Type   | Required | Description                                                                                               |
    | ------------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------- |
    | `sender_address`    | string | Yes      | Sender blockchain address.                                                                                |
    | `recipient_address` | string | Yes      | Recipient blockchain address.                                                                             |
    | `amount`            | number | Yes      | Payment amount in USD equivalent (must be > 0).                                                           |
    | `sender_network`    | string | Yes      | Sender network. Examples: `solana`, `ethereum`, `osmosis-1`.                                              |
    | `recipient_network` | string | Yes      | Recipient network.                                                                                        |
    | `sender_token`      | string | No       | Token/denom being sent. Enables token risk check. Example: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` |
    | `recipient_token`   | string | No       | Token/denom being received.                                                                               |
    | `timestamp`         | string | No       | Payment timestamp (ISO 8601). Example: `2025-01-15T10:30:00Z`                                             |
  </Accordion>

  <Accordion title="get_token_risk" icon="coins">
    Get the risk score for a token by its contract address. Returns risk level, score, and reasoning for whether a token is associated with scams, rug pulls, or malicious activity.

    | Parameter       | Type   | Required | Description                                                                                               |
    | --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------- |
    | `asset_address` | string | Yes      | Token contract or mint address. Example: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` (USDC on Solana). |
    | `network`       | string | No       | Blockchain network. Currently `solana` only. Default: `solana`.                                           |
  </Accordion>

  <Accordion title="check_sanctions" icon="ban">
    Check if a blockchain address is OFAC sanctioned or blacklisted by stablecoin issuers (Tether USDT, Circle USDC, Coinbase, Paxos). Returns `is_ofac_sanctioned` and `is_token_blacklisted` flags with full event history.

    | Parameter         | Type    | Required | Description                                                                                    |
    | ----------------- | ------- | -------- | ---------------------------------------------------------------------------------------------- |
    | `address`         | string  | Yes      | Blockchain address. Supports EVM (`0x...`), Solana (base58), and Tron (`T...`) formats.        |
    | `network`         | string  | No       | Filter by network: `ethereum`, `tron`, or `solana`. If omitted, checks all supported networks. |
    | `include_details` | boolean | No       | Include full blacklist event history and attribution. Default: `true`.                         |
  </Accordion>
</AccordionGroup>

***

## Address Intelligence

<AccordionGroup>
  <Accordion title="get_address_info" icon="address-card">
    Get identifying information for a blockchain address: entity name, category, labels, and tags. Identifies whether an address belongs to a known exchange, mixer, protocol, or other entity.

    | Parameter | Type   | Required | Description                                                                   |
    | --------- | ------ | -------- | ----------------------------------------------------------------------------- |
    | `address` | string | Yes      | Blockchain address.                                                           |
    | `network` | string | Yes      | Network ID. Examples: `eth`, `solana`, `stellar`, `cosmoshub-4`, `osmosis-1`. |
  </Accordion>

  <Accordion title="get_address_connections" icon="diagram-project">
    Get counterparty addresses that a given address has interacted with. Essential for building a transaction graph and tracing money flows. Returns connected addresses with labels and transfer statistics.

    | Parameter    | Type    | Required | Description                                                |
    | ------------ | ------- | -------- | ---------------------------------------------------------- |
    | `address`    | string  | Yes      | Blockchain address to find counterparties for.             |
    | `network`    | string  | Yes      | Network ID.                                                |
    | `size`       | integer | No       | Number of counterparties to return (1–100). Default: `10`. |
    | `start_time` | string  | No       | Filter connections from this time (ISO 8601).              |
    | `end_time`   | string  | No       | Filter connections until this time (ISO 8601).             |
  </Accordion>

  <Accordion title="get_address_transactions" icon="list">
    Get transaction history for a blockchain address. Returns a paginated list with amounts, counterparties, and timestamps.

    | Parameter   | Type    | Required | Description                                        |
    | ----------- | ------- | -------- | -------------------------------------------------- |
    | `address`   | string  | Yes      | Blockchain address.                                |
    | `network`   | string  | Yes      | Network ID.                                        |
    | `limit`     | integer | No       | Transactions to return (1–500). Default: `50`.     |
    | `offset`    | integer | No       | Transactions to skip for pagination. Default: `0`. |
    | `startTime` | string  | No       | Filter from this time (ISO 8601).                  |
    | `endTime`   | string  | No       | Filter until this time (ISO 8601).                 |
    | `status`    | string  | No       | Filter by status: `success` or `failed`.           |
    | `msgTypes`  | string  | No       | Filter by message types (comma-separated).         |
  </Accordion>

  <Accordion title="get_address_features" icon="chart-bar">
    Get detailed behavioral statistics for an address: transaction counts, volumes, token interactions, active duration, unique counterparties, and daily activity patterns. Use for behavioral profiling.

    | Parameter | Type   | Required | Description         |
    | --------- | ------ | -------- | ------------------- |
    | `address` | string | Yes      | Blockchain address. |
    | `network` | string | Yes      | Network ID.         |
  </Accordion>

  <Accordion title="get_address_funded_by" icon="arrow-right-to-bracket">
    Find the source of funds for an address — which address initially funded it, when, and with what amount. Critical for tracing the origin of funds in an investigation.

    | Parameter | Type   | Required | Description                                        |
    | --------- | ------ | -------- | -------------------------------------------------- |
    | `address` | string | Yes      | Blockchain address to find the funding source for. |
    | `network` | string | Yes      | Network ID.                                        |
  </Accordion>

  <Accordion title="get_address_balance" icon="wallet">
    Get current token balances for a blockchain address across all tokens it holds.

    | Parameter         | Type   | Required | Description                                                 |
    | ----------------- | ------ | -------- | ----------------------------------------------------------- |
    | `address`         | string | Yes      | Blockchain address.                                         |
    | `network`         | string | Yes      | Network ID.                                                 |
    | `network_type`    | string | No       | Architecture type: `evm`, `solana`, `cosmos`.               |
    | `token_contracts` | string | No       | Comma-separated token contract addresses to filter results. |
  </Accordion>

  <Accordion title="get_address_stats" icon="square-poll-vertical">
    Get aggregate statistics for an address: total transaction count, total volume, unique counterparties, active days, and more. Useful for quickly profiling activity level.

    | Parameter | Type   | Required | Description                                                |
    | --------- | ------ | -------- | ---------------------------------------------------------- |
    | `address` | string | Yes      | Blockchain address.                                        |
    | `network` | string | Yes      | Network ID. Examples: `ethereum`, `solana`, `cosmoshub-4`. |
  </Accordion>

  <Accordion title="get_address_payments" icon="arrow-right-arrow-left">
    Get payment history for a blockchain address. Payments are cross-chain and intrachain value transfers. Supports filtering by direction, time range, and counterparty.

    | Parameter          | Type    | Required | Description                                          |
    | ------------------ | ------- | -------- | ---------------------------------------------------- |
    | `address`          | string  | Yes      | Blockchain address.                                  |
    | `network`          | string  | No       | Network ID.                                          |
    | `limit`            | integer | No       | Payments to return (1–500). Default: `50`.           |
    | `offset`           | integer | No       | Payments to skip for pagination. Default: `0`.       |
    | `direction`        | string  | No       | `incoming`, `outgoing`, or `both`. Default: `both`.  |
    | `start_time`       | string  | No       | Filter from this time (ISO 8601).                    |
    | `end_time`         | string  | No       | Filter until this time (ISO 8601).                   |
    | `receiver`         | string  | No       | Filter payments involving this counterparty address. |
    | `receiver_network` | string  | No       | Network of the counterparty address.                 |
  </Accordion>

  <Accordion title="get_payment_by_hash" icon="receipt">
    Get full details of a specific payment by transaction hash: sender, receiver, amounts, token details, and timestamps.

    | Parameter | Type   | Required | Description                             |
    | --------- | ------ | -------- | --------------------------------------- |
    | `hash`    | string | Yes      | Payment or transaction hash to look up. |
  </Accordion>

  <Accordion title="get_address_asset_flow" icon="arrows-left-right">
    Get net inflow and outflow per token for a blockchain address. Shows which tokens an address has been accumulating or distributing over time.

    | Parameter      | Type   | Required | Description                                                |
    | -------------- | ------ | -------- | ---------------------------------------------------------- |
    | `address`      | string | Yes      | Blockchain address.                                        |
    | `network`      | string | Yes      | Network ID. Examples: `ethereum`, `solana`, `cosmoshub-4`. |
    | `network_type` | string | No       | Architecture type: `evm`, `solana`, `cosmos`.              |
  </Accordion>

  <Accordion title="search_entities" icon="building">
    Search for known blockchain entities by name or label. Find exchanges (Binance, Coinbase), mixers (Tornado Cash), protocols (Uniswap), and other labeled addresses across chains.

    | Parameter     | Type   | Required | Description                                                                                |
    | ------------- | ------ | -------- | ------------------------------------------------------------------------------------------ |
    | `search_term` | string | Yes      | Name or partial name to search for. Examples: `"Binance"`, `"Coinbase"`, `"Tornado Cash"`. |
    | `networks`    | string | No       | Comma-separated networks to filter by. Examples: `ethereum,solana`.                        |
  </Accordion>
</AccordionGroup>

***

## Transfers & Transactions

<AccordionGroup>
  <Accordion title="get_transfers" icon="paper-plane">
    Get token transfer history for a blockchain address. Returns transfers with sender, receiver, token symbol, USD amount, timestamp, and bridge type. Covers cross-chain and intrachain transfers.

    | Parameter              | Type    | Required | Description                                                       |
    | ---------------------- | ------- | -------- | ----------------------------------------------------------------- |
    | `address`              | string  | Yes      | Blockchain address.                                               |
    | `network`              | string  | No       | Filter by network. Examples: `solana`, `ethereum`, `cosmoshub-4`. |
    | `size`                 | integer | No       | Number of transfers (1–10000). Default: `25`.                     |
    | `cursor`               | string  | No       | Pagination cursor from previous response.                         |
    | `token_symbols`        | string  | No       | Comma-separated token symbols. Examples: `USDC,DAI,SOL`.          |
    | `status`               | string  | No       | Comma-separated statuses: `SUCCEEDED,FAILED`.                     |
    | `min_usd`              | number  | No       | Minimum USD amount filter.                                        |
    | `max_usd`              | number  | No       | Maximum USD amount filter.                                        |
    | `start_time`           | string  | No       | Filter from this time (ISO 8601).                                 |
    | `end_time`             | string  | No       | Filter until this time (ISO 8601).                                |
    | `source_networks`      | string  | No       | Comma-separated source networks.                                  |
    | `destination_networks` | string  | No       | Comma-separated destination networks.                             |
    | `bridges`              | string  | No       | Comma-separated bridge types. Examples: `ibc,cctp`.               |
  </Accordion>

  <Accordion title="get_transfers_between" icon="arrows-left-right-to-line">
    Get all transfers between two specific blockchain addresses. Useful for investigating direct financial relationships between two wallets, including cross-chain flows.

    | Parameter    | Type    | Required | Description                                                        |
    | ------------ | ------- | -------- | ------------------------------------------------------------------ |
    | `address_a`  | string  | Yes      | First blockchain address.                                          |
    | `network_a`  | string  | Yes      | Network of address A. Examples: `solana`, `ethereum`, `osmosis-1`. |
    | `address_b`  | string  | Yes      | Second blockchain address.                                         |
    | `network_b`  | string  | Yes      | Network of address B.                                              |
    | `size`       | integer | No       | Number of transfers (1–100). Default: `10`.                        |
    | `start_time` | string  | No       | Filter from this time (ISO 8601).                                  |
    | `end_time`   | string  | No       | Filter until this time (ISO 8601).                                 |
    | `types`      | string  | No       | Transfer types (comma-separated). Examples: `ibc,cctp`.            |
    | `cursor`     | string  | No       | Pagination cursor.                                                 |
  </Accordion>

  <Accordion title="get_transaction_details" icon="file-lines">
    Get full details of a blockchain transaction by network and hash: sender, receiver, amounts, token transfers, fees, and timestamp.

    | Parameter | Type   | Required | Description                                                                                                               |
    | --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
    | `network` | string | Yes      | Blockchain network. Examples: `ethereum`, `solana`, `cosmoshub-4`, `osmosis-1`, `dydx-mainnet-1`, `neutron-1`, `stellar`. |
    | `hash`    | string | Yes      | Transaction hash to look up.                                                                                              |
  </Accordion>
</AccordionGroup>

***

## Network Analytics

<AccordionGroup>
  <Accordion title="get_whale_moves" icon="fish">
    Get large-value transactions on a blockchain network within a time range, sorted by USD value. Useful for identifying market-moving activity, suspicious large flows, or tracking major players.

    | Parameter    | Type    | Required | Description                                                        |
    | ------------ | ------- | -------- | ------------------------------------------------------------------ |
    | `network`    | string  | Yes      | Blockchain network. Examples: `ethereum`, `solana`, `cosmoshub-4`. |
    | `start_time` | string  | Yes      | Start of time range (ISO 8601). Example: `2024-01-01T00:00:00Z`.   |
    | `end_time`   | string  | Yes      | End of time range (ISO 8601). Example: `2024-01-07T23:59:59Z`.     |
    | `limit`      | integer | No       | Number of results (1–100). Default: `10`.                          |
    | `symbol`     | string  | No       | Filter by token symbol. Examples: `USDC`, `ETH`, `SOL`.            |
  </Accordion>

  <Accordion title="get_network_volume" icon="chart-line">
    Get total transaction volume in USD for a blockchain network within a specific time range.

    | Parameter    | Type   | Required | Description                                                        |
    | ------------ | ------ | -------- | ------------------------------------------------------------------ |
    | `network`    | string | Yes      | Blockchain network. Examples: `ethereum`, `solana`, `cosmoshub-4`. |
    | `start_time` | string | Yes      | Start of time range (ISO 8601).                                    |
    | `end_time`   | string | Yes      | End of time range (ISO 8601).                                      |
  </Accordion>
</AccordionGroup>