Skip to main content
The Range MCP server exposes 74 tools, strictly read-only, across 9 categories: workspace and account data, alerts, counterparties, screening and risk, and blockchain analytics (address intelligence, transfers, network/token stats, and explorer utilities). 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> (or x-api-key: <api_key>)
Tools marked Workspace-scoped require a workspace API key (<workspaceId>.<jwt>), not a legacy/global key. Calling a workspace-scoped tool with a legacy key returns a clear error asking for a workspace-scoped key instead of silently returning empty or wrong data. See the Quickstart for details on key types.

​
Workspace & Account Management

Accounts, balances, groups, and connections tracked inside your Range workspace — wallets, exchange accounts, custodial accounts, multisigs, and bank accounts.
List accounts tracked in the caller workspace: on-chain wallets, exchange accounts, custodial accounts, multisigs, and bank accounts. Supports filtering by group, account type, connection provider, chain, or connection id. Use this for portfolio/treasury overviews before drilling into a single account with get_account.Workspace-scoped.
Get a single account in the caller workspace by its id, including balances, connection details, and group membership. Returns null if no account with that id exists in the workspace.Workspace-scoped.
Get current balances for every account stored in the caller workspace, grouped by address/network with per-asset amounts and USD values. Use for a quick total-holdings snapshot across the whole workspace.Workspace-scoped. No parameters.
List all groups defined for the caller workspace, including built-in system groups. Groups are used to tag/organize accounts (e.g. “Finance”, “Cold Storage”) and can be passed as group_id to list_accounts.Workspace-scoped. No parameters.
List account connections (linked custodian/exchange/bank/multisig integrations such as Utila, Kraken, Plaid, Safe, Squads) configured in the caller workspace. Only non-sensitive public metadata is returned — provider credentials and secrets are never exposed.Workspace-scoped.
Get recent transactions merged across every connection-linked account in the caller workspace (e.g. Kraken trades, Utila custody transfers, bank transactions), sorted newest-first. This is a recent-activity overview, not a full paginated history. Connections whose provider doesn’t support transactions, or that fail to fetch, are skipped.Workspace-scoped.

​
Workspace Admin & Plans

Workspace identity and the global Range plan catalogue.
Get the calling workspace’s identity: workspace id and name, resolved server-side from the caller’s API key. Use when the user asks about their own workspace. Per-workspace plan assignment is not yet accessible via the Range API, so no plan is returned — use get_workspace_plans for the global plan catalogue. Returns found: false if the workspace has no stored record yet.Workspace-scoped. No parameters.
Get every Range subscription plan definition, with numeric rank and per-feature limits (max alert rules, trail/investigation tabs, tracked addresses). This is the global plan catalogue, not the caller workspace’s current plan assignment.Not workspace-scoped — works with any valid API key. No parameters.

​
Alerts & Rules

Alert rules, fired events, templates, and delivery channels configured for your workspace.
List the active alert rules configured for the authenticated workspace. An alert rule is a live subscription (created from a template) that fires alert events when its trigger condition is met. Filter by network, severity, or a name search.Workspace-scoped.
Get a single alert rule by id, including its parameters, trigger, version, subscribed channels, and the template it was created from.Workspace-scoped.
List alert events (fired instances of alert rules) for the authenticated workspace, newest first. Filter by network, severity, exact transaction hash, a UTC date range, or a full-text search across the event caption and involved addresses. Cursor-paginated.Workspace-scoped.
Get a single alert event by id. Returns the fired event with its timestamp, severity, caption, involved addresses, structured details, and access_type (the caller workspace’s relationship to the event).Workspace-scoped.
List the alert rule templates available to the authenticated workspace, grouped by rule type with the networks each covers. A template is the blueprint an alert rule is created from. Filter by network, severity, tags, or a name/description search.Workspace-scoped.
Get a single alert rule template by id. Returns its message, severity, tags, trigger cadence, and the parameters required to turn it into an active alert rule.Workspace-scoped.
List the alert delivery channels (Slack, Discord, PagerDuty, email, webhook, Telegram, incident.io, etc.) configured for the authenticated workspace, including disabled ones. Sensitive delivery params (email addresses, tokens) are redacted.Workspace-scoped.
Get a single alert delivery channel by id, including its type, enabled/connected status, and type-specific delivery params. Sensitive params are redacted — this never returns raw delivery secrets.Workspace-scoped.

​
Counterparties & Enrichment

Vendors, customers, investors, and partners recorded in your workspace, plus the notes and categories attached to transfers.
List counterparties (vendors, customers, investors, partners, exchanges, etc.) recorded for the workspace, with optional type/name filtering. Use this to find a counterparty before looking up its details, addresses, or bank accounts.Workspace-scoped.
Get full details for a single counterparty by id: name, type, website, notes, linked addresses, bank accounts, and document metadata. Use list_counterparties first to find the id.Workspace-scoped.
Look up the workspace note and category recorded against a transfer, identified by its on-chain transaction hash and network. Returns an empty result if the transfer has not been enriched or cannot be found.Workspace-scoped.
List free-text notes the workspace has attached to transfers. Omit transfer_id to list all notes for the workspace, or pass it to fetch a single transfer’s note.Workspace-scoped.
List the accounting/spend categories the workspace has assigned to transfers (e.g. Payroll, Revenue, Gas Fees). Optionally filter to a single transfer or a set of category names. Use get_risk_categories/list_risk_signals for risk taxonomy instead — this is transfer bookkeeping, not risk.Workspace-scoped.

​
Screening & Risk

The v2 screening pipeline (workspace-configurable attribution/exposure/behaviour signals) and the v1 graph-based risk tools (fixed scoring, no workspace configuration). Use screen_address when the workspace has customized its risk signals; use get_address_risk for the fixed graph-based score.
Run the v2 screening pipeline against a single blockchain address: workspace-configurable attribution, exposure, and behaviour signals, reduced to an overall severity (none/low/medium/high/severe). Evidence is omitted by default; pass include_evidence=true for it inline, or fetch it later with get_screening_evidence using the returned screen_id.Workspace-scoped.
Run the v2 screening pipeline (see screen_address) against up to 50 addresses in one call. Network is derived per-address from its format. Per-address failures do not fail the whole batch — check the response meta (total/scored/errors) for partial-failure counts.Workspace-scoped.
List past v2 screening results (screen_address / screen_addresses_batch calls) for the calling workspace, most recent first. Use this to re-find a screen_id without re-running a screen.Workspace-scoped.
Get the full evidence breakdown for a previously issued screen_id (from screen_address, screen_addresses_batch, or get_screening_history), grouped by pillar (attribution, exposure, behaviour) and signal, alongside the original risk assessment.Workspace-scoped — the screen_id must belong to the calling workspace.
Get the calling workspace’s active v2 risk configuration: which attribution signals, exposure signals, and behaviours are enabled and at what severity/thresholds. A workspace with no stored config gets a seeded default on first read. Use list_risk_signals to see the full catalogue available to configure.Workspace-scoped. No parameters.
List the global catalogue of attribution signals, exposure signals, and behaviours available across all workspaces for the v2 screening pipeline. This is read-only reference metadata — it is not auto-applied to any workspace; see get_screening_config for what a specific workspace actually has enabled.Not workspace-scoped — works with any valid API key. No parameters.
Get the calling workspace’s v1 risk category settings (legacy category taxonomy used for address/entity labelling, e.g. sanctions, mixer, scam). This is a separate, older configuration surface from the v2 signals/behaviours exposed via get_screening_config/list_risk_signals.Workspace-scoped. No parameters.
Get the calling workspace’s v1 behavior pattern settings (legacy behaviour taxonomy, e.g. smurfing, structuring). This is a separate, older configuration surface from the v2 behaviours exposed via get_screening_config/list_risk_signals.Workspace-scoped. No parameters.
Get the v1 risk score for a blockchain address. Returns a risk level (VERY_LOW to CRITICAL), numeric score, reasoning, malicious addresses found in the transaction graph, and entity attribution. Often the first call in an investigation.
Get the risk score for a transaction by hash. Evaluates all addresses involved and returns the highest risk score found with per-address risk details.
Assess the risk of a proposed cross-chain payment between two addresses. 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.
Get the risk score for a token/asset by its contract/mint address. Returns risk level, score, and reasoning for whether a token is associated with scams, rug pulls, or malicious activity. Currently supports Solana tokens.
Check if a blockchain address is OFAC sanctioned or blacklisted by token issuers (Tether USDT, Circle USDC, Coinbase, Paxos). Returns is_ofac_sanctioned and is_token_blacklisted flags with detailed event history. Supports Ethereum, Tron, and Solana.

​
Address Intelligence

Labels, connections, transaction history, balances, and behavioral stats for any blockchain address.
Get information about a blockchain address including labels, entity name, category, and tags. Identifies whether an address belongs to a known exchange, mixer, protocol, or other entity.
Get counterparty addresses that a given address has interacted with. Essential for tracing money flows and building a transaction graph. Returns connected addresses with labels and transfer statistics.
Get transaction history for a blockchain address with optional filters by time range and status. Returns a paginated list of transactions with amounts, counterparties, and timestamps.
Get detailed statistical features for a blockchain address: transaction counts, volumes, token interactions, active duration, unique counterparties, and daily activity patterns. Use for behavioral analysis.
Find the source of funds for a blockchain address — which address initially funded it, when, and with what amount. Critical for tracing the origin of funds in an investigation.
Get current token balances for a blockchain address across all tokens it holds.
Get aggregate statistics for a blockchain address: total transaction count, total volume, unique counterparties, active days, and more. Useful for quickly profiling how active an address is.
Get the payment history for a blockchain address. Payments are cross-chain and intrachain value transfers. Supports filtering by direction (incoming/outgoing), time range, counterparty address, and message type.
Get full details of a specific payment by its transaction hash. Returns sender, receiver, amounts, token details, and timestamps for a single payment event.
Get asset flow summary for a blockchain address showing net inflows and outflows per token. Useful for understanding which tokens an address has been accumulating or distributing over time.
Search for known blockchain entities and addresses by name or label. Find exchanges (Binance, Coinbase), mixers (Tornado Cash), protocols (Uniswap), and other labeled addresses.

​
Transfers & Transaction Detail

Token transfer history and full transaction detail lookups.
Get token transfer history for a blockchain address with rich filtering options. Returns transfers with sender, receiver, token symbol, USD amount, timestamp, and bridge type. Supports cross-chain and intrachain transfers.Workspace-scoped when only_workspace is set to true — otherwise usable with any valid API key.
Get all transfers directly between two specific blockchain addresses, even across different networks. Useful for investigating direct relationships and money flows between two wallets.
Get full details of a blockchain transaction by network and hash. Returns sender, receiver, amounts, token transfers, fees, and timestamp. Use this to understand exactly what happened in a specific transaction.

​
Network & Token Stats

Aggregate network activity — whale moves, volume, active accounts, message-type breakdowns — and token supply/holder data.
Get large-value transactions (“whale moves”) on a blockchain network within a time range. Returns the biggest transfers sorted by USD value. Useful for identifying market-moving activity, suspicious large flows, or tracking major players.
Get total transaction volume for a blockchain network within a specific time range in USD. Useful for understanding overall network activity levels during an investigation time window.
Get transaction counts for one or more blockchain networks, bucketed over time. Returns per-network time-series points (count, failed count) plus a running total. Useful for spotting activity spikes or comparing throughput across networks.
Get the count of distinct active accounts on a blockchain network within a time range. Useful for gauging user/address engagement on a network over a given window.
Get the top sending and top receiving addresses on a network, ranked by an aggregated numeric field (e.g. transfer amount) within a time range. Returns two ranked lists: topSenders and topReceivers.
Get the addresses holding the largest USD-denominated balances on a network, as of the latest snapshot. Useful for identifying whales or high-value holders on a chain.
Get the distribution of message/transaction types seen on a network (e.g. Cosmos SDK Msg types), with counts. Useful for understanding what kinds of activity dominate a chain.
Search for a transaction by its hash across supported networks without knowing which network it belongs to. Returns matching hash/height/network/time records — use get_transaction_details afterwards for full transaction data once the network is known.
Get the latest indexed summary for a token (supply, holder count, etc.) on a given network. Returns { found: false } if no summary has been indexed yet for the token/network pair.
Get the on-chain total supply of a token, read live from the network. Supports Solana (SPL mint address) and EVM-compatible networks (ERC-20 contract address). Only a small set of tokens are currently mapped.
Get mint and burn events for a token. For EVM networks these are Transfer events to/from the zero address; for Solana these are mintTo/burn SPL-token instructions. Useful for tracking supply inflation/deflation over time.
Get the top holders of a token, ranked by balance, from the latest indexed snapshot. Useful for concentration analysis (e.g. how much of supply is held by the top N wallets).

​
Explorer Stats & Utilities

Explorer-level leaderboards, cross-chain flow, transaction search, plain-language transaction explanation, and the entity directory.
Get the top addresses on an explorer/network by transaction volume and by transaction count over a given duration. Returns two ranked lists (topAddressesByVolume, topAddressesByTransactions).
Get the top protocols on an explorer/network by transaction volume and by transaction count over a given duration. Returns two ranked lists (topProtocolsByVolume, topProtocolsByTransactions).
Get the top assets on an explorer/network ranked by transaction volume over a given duration. Useful for seeing which tokens are moving the most value right now.
Get cross-network transfer flow over a given duration: which network pairs are sending value to each other, broken down by transfer type. Useful for visualizing or reasoning about interchain money movement.
Get cross-chain (interchain) transfer volume over time, grouped by a field (e.g. token) and bucketed into an interval. Returns periodic series per group plus totals, with smaller groups rolled into an “Others” bucket.
List all stablecoin token symbols tracked in the stablecoin transfers index. Useful as a reference lookup before filtering other tools (e.g. get_top_assets, get_transfers) to stablecoin activity only.No parameters.
Get aggregate statistics for a named protocol (interchain payments type) within a time range: total transaction count, total USD volume, and a per-denom breakdown.
Search/list transactions on a single network with optional filters (address, tx hash, message types, status, time range). Returns a cursor-paginated page of transactions. Use get_transaction_details instead if you already know the exact network+hash.
Explain a blockchain transaction in plain language. Given just a network and transaction hash, returns a human-readable narrative of what happened — the primary action (e.g. swap, transfer, stake, contract call), who the parties are, and any token or native-asset movements with resolved amounts and USD value. Supports Solana and EVM (Ethereum-family) networks. Use this when you need to describe a transaction to a person or triage an unfamiliar transaction quickly.
Get a single transfer by its opaque transfer id (as returned in transfer lists, e.g. from get_transfers). Returns full transfer detail including sender/receiver, token, USD amount, and bridge type.
Get the busiest networks for transfers over the last 7 days, split into sender_networks and receiver_networks with counts. Useful for understanding which chains dominate transfer volume right now.
Get the most-transferred assets over the last 7 days, with counts. Useful for understanding which tokens dominate transfer activity right now.
Browse the curated entity directory: named organizations, protocols, exchanges, DAOs, bridges, and similar entities, each with tags, verification status, TVL, and monthly volume, sorted by monthly volume. Cursor-paginated, optionally filtered by network. Different from search_entities, which does free-text lookup over individually labeled addresses — this browses the entity-level registry itself.
Get an enriched block for a network at a given height (for Solana, the slot number). Returns the decoded block payload. Useful for inspecting everything that happened in a specific block.
Last modified on July 9, 2026