BlockReq is an MCP server published by com.blockreq, hosted at mcp.blockreq.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including list_chains, get_chain, search_docs, get_doc_page, get_method_reference.
Read-only BlockReq docs, EVM JSON-RPC, and on-chain DEX and wallet data
1 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List every published BlockReq network with its host, public trial URL, private URL pattern ({API_KEY} placeholder), WSS support, and archive and proof/debug/trace flags.
| Parameter | Type | Description |
|---|---|---|
| network_type | string | Only this network type |
{
"name": "list_chains",
"title": "List BlockReq networks",
"description": "List every published BlockReq network with its host, public trial URL, private URL pattern ({API_KEY} placeholder), WSS support, and archive and proof/debug/trace flags.",
"inputSchema": {
"type": "object",
"properties": {
"network_type": {
"enum": [
"mainnet",
"testnet",
"beacon"
],
"type": "string",
"description": "Only this network type"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one network's URLs and capability flags, its API reference page, and (for EVM networks) the JSON-RPC methods documented for it.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1) |
{
"name": "get_chain",
"title": "Get one BlockReq network",
"description": "Get one network's URLs and capability flags, its API reference page, and (for EVM networks) the JSON-RPC methods documented for it.",
"inputSchema": {
"type": "object",
"required": [
"chain"
],
"properties": {
"chain": {
"type": "string",
"description": "Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the BlockReq docs (setup, API keys, endpoints, Request Counting, plans, networks, support). Returns page titles, URLs, Markdown URLs for get_doc_page, and snippets. Chinese queries search the Chinese pages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Most results to return (default 5) |
| query * | string | Words to search for |
| locale | string | Docs language; defaults to the query's language |
{
"name": "search_docs",
"title": "Search BlockReq docs",
"description": "Search the BlockReq docs (setup, API keys, endpoints, Request Counting, plans, networks, support). Returns page titles, URLs, Markdown URLs for get_doc_page, and snippets. Chinese queries search the Chinese pages.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Most results to return (default 5)"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Words to search for"
},
"locale": {
"enum": [
"en",
"zh-cn"
],
"type": "string",
"description": "Docs language; defaults to the query's language"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read one BlockReq docs page as Markdown. Accepts a https://blockreq.com/docs/... URL (HTML or index.md) or a path such as /docs/getting-started/.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Docs page URL or path |
{
"name": "get_doc_page",
"title": "Read a BlockReq docs page",
"description": "Read one BlockReq docs page as Markdown. Accepts a https://blockreq.com/docs/... URL (HTML or index.md) or a path such as /docs/getting-started/.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Docs page URL or path"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the documented parameters, result, example, and endpoints of one JSON-RPC method on one EVM network, from BlockReq's OpenRPC document.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1) |
| method * | string | JSON-RPC method, for example eth_getLogs |
{
"name": "get_method_reference",
"title": "Get a JSON-RPC method reference",
"description": "Get the documented parameters, result, example, and endpoints of one JSON-RPC method on one EVM network, from BlockReq's OpenRPC document.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"method"
],
"properties": {
"chain": {
"type": "string",
"description": "Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1)"
},
"method": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "JSON-RPC method, for example eth_getLogs"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Call one read-only JSON-RPC method on an EVM network. Without credentials it uses the public trial endpoint (rate-limited, recent state only); when this MCP connection sends a BlockReq API key or is signed in to a BlockReq account, it uses the caller's own endpoint, metered to their account with their plan's limits and history. eth_getLogs needs numeric fromBlock/toBlock at most 1000 blocks apart, or a blockHash. Responses above 256 KB are refused. It cannot sign or send transactions.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1) |
| method * | string | one of ["eth_blockNumber","eth_chainId","eth_getBalance","eth_call","eth_getLogs","eth_getTransactionByHash","eth_getTransactionReceipt","eth_getCode","eth_getStorageAt","eth_getBlockByNumber"] |
| params | array | Positional JSON-RPC params; a missing block parameter means latest |
{
"name": "call_rpc",
"title": "Call a read-only JSON-RPC method",
"description": "Call one read-only JSON-RPC method on an EVM network. Without credentials it uses the public trial endpoint (rate-limited, recent state only); when this MCP connection sends a BlockReq API key or is signed in to a BlockReq account, it uses the caller's own endpoint, metered to their account with their plan's limits and history. eth_getLogs needs numeric fromBlock/toBlock at most 1000 blocks apart, or a blockHash. Responses above 256 KB are refused. It cannot sign or send transactions.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"method"
],
"properties": {
"chain": {
"type": "string",
"description": "Network slug (for example ethereum, base, arbitrum-sepolia), catalog id, hostname, name, or EVM chain ID (1 or 0x1)"
},
"method": {
"enum": [
"eth_blockNumber",
"eth_chainId",
"eth_getBalance",
"eth_call",
"eth_getLogs",
"eth_getTransactionByHash",
"eth_getTransactionReceipt",
"eth_getCode",
"eth_getStorageAt",
"eth_getBlockByNumber"
],
"type": "string"
},
"params": {
"type": "array",
"description": "Positional JSON-RPC params; a missing block parameter means latest"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Find tokens by symbol, name or address, each with its pool, price in USD, liquidity and 24h volume; the deepest pools come first. Anonymous and read-only.
| Parameter | Type | Description |
|---|---|---|
| chain | string | Only this chain; every chain when omitted (ethereum, base, arbitrum) |
| limit | integer | Most pools to return (default 10) |
| query * | string | Symbol, name or address to search for (at least 2 characters) |
{
"name": "search_tokens",
"title": "Search tokens and pools",
"description": "Find tokens by symbol, name or address, each with its pool, price in USD, liquidity and 24h volume; the deepest pools come first. Anonymous and read-only.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Only this chain; every chain when omitted (ethereum, base, arbitrum)"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Most pools to return (default 10)"
},
"query": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "Symbol, name or address to search for (at least 2 characters)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}One token's USD price with the block and time it was read at, 24h change and volume, the pool the price comes from, and whether liquidity is low. price_time is when the price last changed, age_seconds is how old that is now, and indexed_time and indexed_block say how far the chain's indexing has got. When stale is true the price must not be presented as the current price; say how old it is instead. Use search_tokens first when you only know the symbol.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Chain: ethereum, base, arbitrum |
| address * | string | Token contract address (0x and 40 hex digits, any case) |
{
"name": "get_token",
"title": "Get a token's price",
"description": "One token's USD price with the block and time it was read at, 24h change and volume, the pool the price comes from, and whether liquidity is low. price_time is when the price last changed, age_seconds is how old that is now, and indexed_time and indexed_block say how far the chain's indexing has got. When stale is true the price must not be presented as the current price; say how old it is instead. Use search_tokens first when you only know the symbol.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Token contract address (0x and 40 hex digits, any case)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Current USD prices of up to 50 tokens in one call, across chains, in the order asked. A token without a price comes back with null price_usd. Each row carries price_time (when the price last changed), age_seconds (how old that is now), indexed_time and indexed_block (how far the chain's indexing has got); a row with stale true must not be presented as a current price.
| Parameter | Type | Description |
|---|---|---|
| tokens * | array | Tokens to price, each {chain, address} |
{
"name": "get_token_prices",
"title": "Get prices of several tokens",
"description": "Current USD prices of up to 50 tokens in one call, across chains, in the order asked. A token without a price comes back with null price_usd. Each row carries price_time (when the price last changed), age_seconds (how old that is now), indexed_time and indexed_block (how far the chain's indexing has got); a row with stale true must not be presented as a current price.",
"inputSchema": {
"type": "object",
"required": [
"tokens"
],
"properties": {
"tokens": {
"type": "array",
"items": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Token contract address (0x and 40 hex digits, any case)"
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Tokens to price, each {chain, address}"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A token's USD candles (open, high, low, close, USD volume, trades), oldest first, the latest 32 by default. Use from and to (Unix seconds) for a past range.
| Parameter | Type | Description |
|---|---|---|
| to | integer | Range end in Unix seconds (default now) |
| from | integer | Range start in Unix seconds, inclusive |
| chain * | string | Chain: ethereum, base, arbitrum |
| limit | integer | Most candles to return (default 32) |
| address * | string | Token contract address (0x and 40 hex digits, any case) |
| interval | string | Candle interval (default 1h) |
{
"name": "get_token_candles",
"title": "Get a token's USD candles",
"description": "A token's USD candles (open, high, low, close, USD volume, trades), oldest first, the latest 32 by default. Use from and to (Unix seconds) for a past range.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"to": {
"type": "integer",
"minimum": 0,
"description": "Range end in Unix seconds (default now)"
},
"from": {
"type": "integer",
"minimum": 0,
"description": "Range start in Unix seconds, inclusive"
},
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"limit": {
"type": "integer",
"default": 32,
"maximum": 200,
"minimum": 1,
"description": "Most candles to return (default 32)"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Token contract address (0x and 40 hex digits, any case)"
},
"interval": {
"enum": [
"1m",
"5m",
"15m",
"1h",
"4h",
"1d"
],
"type": "string",
"description": "Candle interval (default 1h)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Indexed DEX pools that hold a token, deepest first, with protocol, fee, pair, liquidity, price, 24h volume and trades. The pool id feeds list_pool_trades.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Chain: ethereum, base, arbitrum |
| limit | integer | Most pools to return (default 10) |
| address * | string | Token contract address (0x and 40 hex digits, any case) |
{
"name": "list_token_pools",
"title": "List a token's pools",
"description": "Indexed DEX pools that hold a token, deepest first, with protocol, fee, pair, liquidity, price, 24h volume and trades. The pool id feeds list_pool_trades.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Most pools to return (default 10)"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Token contract address (0x and 40 hex digits, any case)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A pool's trades, newest first, with block number, time, transaction hash, trader, token amounts and USD value. amount0 and amount1 are raw amounts of the pool's token0 and token1 from the pool's point of view: positive means the pool received that token (the trader sold it), negative means the pool paid it out (the trader bought it). trader_bought and trader_sold name which of token0 or token1 the trader got and gave; the trades do not name the tokens, so read them from the pool (search_tokens or the pool's own answer) before saying buy or sell of a particular token. price is whole token1 per whole token0. A full page returns next_cursor; pass it as cursor for older trades.
| Parameter | Type | Description |
|---|---|---|
| pool * | string | Pool address (0x and 40 hex digits), or a Uniswap v4 pool id (0x and 64 hex digits) |
| chain * | string | Chain: ethereum, base, arbitrum |
| limit | integer | Most trades to return (default 20) |
| cursor | string | The next_cursor of the previous page |
{
"name": "list_pool_trades",
"title": "List a pool's recent trades",
"description": "A pool's trades, newest first, with block number, time, transaction hash, trader, token amounts and USD value. amount0 and amount1 are raw amounts of the pool's token0 and token1 from the pool's point of view: positive means the pool received that token (the trader sold it), negative means the pool paid it out (the trader bought it). trader_bought and trader_sold name which of token0 or token1 the trader got and gave; the trades do not name the tokens, so read them from the pool (search_tokens or the pool's own answer) before saying buy or sell of a particular token. price is whole token1 per whole token0. A full page returns next_cursor; pass it as cursor for older trades.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"pool"
],
"properties": {
"pool": {
"type": "string",
"pattern": "^0x([0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
"description": "Pool address (0x and 40 hex digits), or a Uniswap v4 pool id (0x and 64 hex digits)"
},
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Most trades to return (default 20)"
},
"cursor": {
"type": "string",
"pattern": "^[0-9]{1,15}\\.[0-9]{1,12}\\.[0-9]{1,7}$",
"description": "The next_cursor of the previous page"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}A token's largest holders with balance and share of the known supply, as of a block. Only tokens BlockReq tracks have a ranking; others answer not found.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Chain: ethereum, base, arbitrum |
| limit | integer | Most holders to return (default 20) |
| address * | string | Token contract address (0x and 40 hex digits, any case) |
{
"name": "get_token_holders",
"title": "Get a token's largest holders",
"description": "A token's largest holders with balance and share of the known supply, as of a block. Only tokens BlockReq tracks have a ranking; others answer not found.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Most holders to return (default 20)"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Token contract address (0x and 40 hex digits, any case)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}An address's token holdings on one chain with USD values, largest first. Holdings come from BlockReq's holder rankings; list ERC-20 addresses in tokens (up to 50) to read those balances directly from a node.
| Parameter | Type | Description |
|---|---|---|
| chain * | string | Chain: ethereum, base, arbitrum |
| tokens | array | ERC-20 token addresses to read balances of directly (up to 50) |
| address * | string | Account address (0x and 40 hex digits, any case) |
{
"name": "get_account_portfolio",
"title": "Get an address's token holdings",
"description": "An address's token holdings on one chain with USD values, largest first. Holdings come from BlockReq's holder rankings; list ERC-20 addresses in tokens (up to 50) to read those balances directly from a node.",
"inputSchema": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"enum": [
"ethereum",
"base",
"arbitrum"
],
"type": "string",
"description": "Chain: ethereum, base, arbitrum"
},
"tokens": {
"type": "array",
"items": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 token address"
},
"maxItems": 50,
"description": "ERC-20 token addresses to read balances of directly (up to 50)"
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Account address (0x and 40 hex digits, any case)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}BlockReq MCP is public, free, and read-only. Use list_chains or get_chain to find a network's host and capabilities, search_docs and get_doc_page for documentation, get_method_reference for a method's parameters and example on one network, and call_rpc for read-only JSON-RPC calls. Without credentials call_rpc uses the rate-limited public trial endpoint, which does not serve deep history, debug, or trace; when this connection sends Authorization: Bearer <BlockReq API key>, or is signed in through https://mcp.blockreq.com/mcp/account, call_rpc uses the caller's own endpoint, metered to their account. For DEX and wallet data use search_tokens, get_token, get_token_prices, get_token_candles, list_token_pools, list_pool_trades, get_token_holders and get_account_portfolio; each result carries as_of (block and time), the public source request, and access. They answer anonymously within a per-IP limit shared with other callers on the same address; when this connection sends X-Data-Api-Key: <Crypto API key>, or is signed in through https://mcp.blockreq.com/mcp/account, they use the caller's own key and limits instead; when signed in, call the data tools one at a time (the Free plan allows 1 request per second, burst 1). Production code should call a private endpoint with an API key from https://blockreq.com/dashboard.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.