Skip to main content
Glama
CryptoAPIs-io

@cryptoapis-io/mcp-blockchain-fees

Official

@cryptoapis-io/mcp-blockchain-fees

MCP server for Crypto APIs Blockchain Fees product. Fee recommendations and gas estimates for UTXO, EVM, and XRP blockchains.

API Version: Compatible with Crypto APIs version 2024-12-12

Features

  • UTXO fee recommendations and smart fee estimation (Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash)

  • EVM fee recommendations, EIP-1559 fees, and gas estimation for transfers and contract calls

  • XRP fee recommendations

Related MCP server: @cryptoapis-io/mcp-address-history

Prerequisites

Installation

npm install @cryptoapis-io/mcp-blockchain-fees

Or install all Crypto APIs MCP servers: npm install @cryptoapis-io/mcp

Usage

# Run with API key
npx @cryptoapis-io/mcp-blockchain-fees --api-key YOUR_API_KEY

# Or use environment variable
export CRYPTOAPIS_API_KEY=YOUR_API_KEY
npx @cryptoapis-io/mcp-blockchain-fees

# HTTP transport
npx @cryptoapis-io/mcp-blockchain-fees --transport http --port 3000 --api-key YOUR_API_KEY

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "cryptoapis-blockchain-fees": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-blockchain-fees"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cryptoapis-blockchain-fees": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-blockchain-fees"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP Inspector

npx @modelcontextprotocol/inspector npx @cryptoapis-io/mcp-blockchain-fees --api-key YOUR_API_KEY

n8n

  1. Start the server in HTTP mode:

    npx @cryptoapis-io/mcp-blockchain-fees --transport http --port 3000 --api-key YOUR_API_KEY
  2. In your n8n workflow, add an AI Agent node

  3. Under Tools, add an MCP Client Tool and set the URL to http://localhost:3000/mcp

All servers default to port 3000. Use --port to assign different ports when running multiple servers.

Available Tools

blockchain_fees_utxo

Fee recommendations for UTXO blockchains (Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash).

Action

Description

get-fee-recommendations

Get fee recommendations (slow, standard, fast)

estimate-transaction-smart-fee

Estimate smart fee for a target confirmation time

blockchain_fees_evm

Fee recommendations and gas estimation for EVM blockchains.

Action

Description

get-fee-recommendations

Get fee recommendations (slow, standard, fast)

get-eip-1559-fee-recommendations

Get EIP-1559 fee recommendations (base fee, priority fee)

estimate-native-coin-transfer-gas

Estimate gas for native coin transfer

estimate-token-transfer-gas

Estimate gas for token transfer

estimate-contract-interaction-gas

Estimate gas for contract interaction

blockchain_fees_xrp

Fee recommendations for XRP (mainnet, testnet).

Action

Description

get-fee-recommendations

Get XRP fee recommendations

CLI Arguments

Argument

Description

Default

--api-key

Crypto APIs API key

CRYPTOAPIS_API_KEY env var

--transport

Transport type: stdio or http

stdio

--host

HTTP host

0.0.0.0

--port

HTTP port

3000

--path

HTTP path

/mcp

--stateless

Enable stateless HTTP mode

false

HTTP API Key Modes

When using HTTP transport, the server supports two API key modes:

  • With --api-key: The key is used for all requests. x-api-key request headers are ignored.

  • Without --api-key: Each request must include an x-api-key header with a valid Crypto APIs key. This enables hosting a public server where each user provides their own key.

# Per-request key mode (multi-tenant)
npx @cryptoapis-io/mcp-blockchain-fees --transport http --port 3000
# Clients send x-api-key header with each request

Stdio transport always requires an API key at startup.

Important: API Key Required

Warning: Making requests without a valid API key — or with an incorrect one — may result in your IP being banned from the Crypto APIs ecosystem. Always ensure a valid API key is configured before starting any server.

Remote MCP Server

Crypto APIs provides an official remote MCP server with all tools available via HTTP Streamable transport at https://ai.cryptoapis.io/mcp. Pass your API key via the x-api-key header — no installation required.

License

MIT

Available Tools

4 tools
blockchain_fees_evmA

Get fee recommendations and estimate gas costs for EVM blockchains. Use this before preparing or signing a transaction to determine appropriate gas parameters.

Actions: • get-fee-recommendations: Get recommended gas price tiers (slow/standard/fast) • get-eip-1559-fee-recommendations: Get EIP-1559 fee parameters (baseFee, maxPriorityFee) for supported chains • estimate-native-coin-transfer-gas: Estimate gas for a native coin transfer (e.g. ETH, BNB) • estimate-token-transfer-gas: Estimate gas for an ERC-20/ERC-721 token transfer • estimate-contract-interaction-gas: Estimate gas for a smart contract call

Credits by action (source: OpenAPI): • estimate-contract-interaction-gas: arbitrum 192, avalanche 216, base 144, binance-smart-chain 300, ethereum 120, ethereum-classic 156, optimism 168, polygon 240, tron 180 • estimate-native-coin-transfer-gas: arbitrum 192, avalanche 216, base 144, binance-smart-chain 300, ethereum 120, ethereum-classic 156, optimism 168, polygon 240, tron 180 • estimate-token-transfer-gas: arbitrum 192, avalanche 216, base 144, binance-smart-chain 300, ethereum 120, ethereum-classic 156, optimism 168, polygon 240, tron 180 • get-eip-1559-fee-recommendations: arbitrum 48, avalanche 54, base 36, binance-smart-chain 75, ethereum 30, ethereum-classic 39, optimism 42, polygon 60, tron 45 • get-fee-recommendations: arbitrum 48, avalanche 54, base 36, binance-smart-chain 75, ethereum 30, ethereum-classic 39, optimism 42, polygon 60, tron 45

Credits are indicative only and may change at any time. The actual credits spent for each API request are returned in the response headers.

ParametersJSON Schema
NameRequiredDescriptionDefault
dataNoHex-encoded calldata (required for estimate-contract-interaction-gas)
valueNoAmount in native coin's smallest unit, e.g. wei (required for estimate-native-coin-transfer-gas; optional for estimate-contract-interaction-gas)
actionYesAction to perform
amountNoToken amount to transfer (required for estimate-token-transfer-gas)
contextNoOptional context for the request - echoed back in response
networkYesNetwork name
toAddressNoRecipient address (required for native coin and token transfer gas estimation)
blockchainYesBlockchain protocol
fromAddressNoSender address (required for gas estimation actions)
contractTypeNoToken standard: ERC-20 or ERC-721 (estimate-token-transfer-gas only; defaults to ERC-20)
contractAddressNoToken contract address (required for estimate-token-transfer-gas and estimate-contract-interaction-gas)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It conveys that the tool performs estimations (read-only) and lists actions, but does not explicitly state that no transaction is signed or submitted. It does add useful context about credits and response headers, which is a behavioral trait. Still, the lack of an explicit read-only/safety disclosure keeps it from a higher score.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with a clear purpose, but the credits section is excessively long and repetitive, listing the same credit values for multiple actions. This violates the principle that every sentence should earn its place. The core action list is useful, but the redundancy makes the description bloated and less scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 11 parameters and 5 distinct actions, but the description does not guide the agent on which action to choose for a given scenario. The schema hints at required parameters per action, and the action names are self-explanatory, but without an output schema or action-selection guidance, the description is only minimally complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and each parameter already includes detailed descriptions, including action-specific requirements. The tool description's action list duplicates some of this information (e.g., which action requires 'data') without adding new meaning beyond the schema. Therefore, it meets the baseline but does not elevate it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb-resource pair: 'Get fee recommendations and estimate gas costs for EVM blockchains.' This clearly distinguishes the tool from its siblings (UTXO, XRP) by explicitly scoping to EVM. The subsequent action list enumerates concrete operations, leaving no ambiguity about what the tool does.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear guidance on when to use the tool: 'Use this before preparing or signing a transaction to determine appropriate gas parameters.' This gives a concrete context. However, it does not mention alternatives or explicit when-not-to-use scenarios, though the sibling tool names (UTXO/XRP) implicitly differentiate by chain type.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

blockchain_fees_utxoA

Get fee recommendations for UTXO blockchains (bitcoin, bitcoin-cash, litecoin, dogecoin, dash, zcash). Use this before preparing or signing a transaction to determine the appropriate fee rate.

Actions: • get-fee-recommendations: Get recommended fee-per-byte tiers (slow/standard/fast) from the mempool • estimate-transaction-smart-fee: Estimate the fee rate needed for confirmation within a target number of blocks

Credits by action (source: OpenAPI): • estimate-transaction-smart-fee: bitcoin 510, bitcoin-cash 612, dash 561, dogecoin 561, litecoin 561, zcash 663 • get-fee-recommendations: bitcoin 510, bitcoin-cash 612, dash 561, dogecoin 561, litecoin 561, zcash 663

Credits are indicative only and may change at any time. The actual credits spent for each API request are returned in the response headers.

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYesAction to perform
contextNoOptional context for the request - echoed back in response
networkYesNetwork name
blockchainYesBlockchain protocol
feeRatePriorityNoFee rate priority: ECONOMICAL or CONSERVATIVE (estimate-transaction-smart-fee only)
confirmationTargetNoTarget number of blocks for confirmation (estimate-transaction-smart-fee only)

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses the two actions, includes credit costs per action/blockchain, and notes that credits are indicative and actual costs are returned in response headers. This adds meaningful behavioral context beyond the schema, though it doesn't explicitly state read-only behavior or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the main purpose in the first sentence, followed by usage guidance and a structured action list. The credits section is somewhat verbose but serves a purpose (cost transparency). Overall, it's well-organized and each section earns its place, though it could be slightly more compact.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the tool's scope, use cases, available actions, and cost information, which is solid for a fee-recommendation tool. It lacks an output schema but the actions imply the return type. The description is sufficiently complete given the tool's complexity, though it could clarify the meaning of fee tiers or the return structure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and each parameter has a description. The tool description adds action-to-parameter mapping (e.g., feeRatePriority and confirmationTarget are 'estimate-transaction-smart-fee only') but this is also present in the schema. The description doesn't significantly augment the parameter semantics beyond what the schema already provides, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Get fee recommendations for UTXO blockchains' and lists the specific blockchains (bitcoin, bitcoin-cash, litecoin, dogecoin, dash, zcash). It also differentiates from sibling tools by naming the UTXO scope, which contrasts with the EVM and XRP siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit usage context: 'Use this before preparing or signing a transaction to determine the appropriate fee rate.' It also breaks down the two actions and their specific use cases. However, it does not explicitly mention when to avoid this tool or name alternative tools, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

blockchain_fees_xrpA

Blockchain Fees XRP: get fee recommendations. Networks: mainnet, testnet.

Credits per call: 20

Credits are indicative only and may change at any time. The actual credits spent for each API request are returned in the response headers.

ParametersJSON Schema
NameRequiredDescriptionDefault
contextNoOptional context for the request - echoed back in response
networkYesNetwork name

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses credit costs and that actual credits are in response headers, which is useful. However, it does not describe the return format or any side effects, though as a read-only fee tool this is less critical.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded with the purpose. It includes credit info as a separate block, which is relevant but could be considered extraneous. Overall, it is efficient with no fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one required parameter and no output schema. The description gives network options and credit costs, but does not explain what 'fee recommendations' includes or the structure of the response. For a minimal fee tool, this is adequate but has gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: both 'network' (with enum) and 'context' are fully described in the schema. The description only repeats the network names, adding no new parameter semantics. Baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'get fee recommendations' for XRP, with specific network options. It distinguishes itself from sibling tools like blockchain_fees_utxo and blockchain_fees_evm by explicitly naming the chain (XRP) and supported networks.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage: when you need fee recommendations for XRP on mainnet or testnet. However, it does not explicitly state when to prefer this over sibling fee tools or system_info, nor does it mention exclusions or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

system_infoA

CryptoAPIs reference documentation — no API call, no credits consumed.

Actions: • blockchains — Supported blockchains, networks, products per chain, denominations, fiat currencies • errors — Complete error code table (HTTP status, error code, message) • credits — Credit charging structure, cost multipliers per blockchain, monitoring & operations taxes (xPub, synced addresses, blockchain events), pay-as-you-go • callbacks — Webhook mechanics: URL requirements, retry strategy (5 retries, exponential backoff), HMAC security, idempotency • limits — Throughput soft/hard limits per plan, 2.1x penalty multiplier, rate limiting behavior

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYesReference topic to retrieve
contextNoOptional context for the request - echoed back in response

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It clearly states this is a documentation-only tool with no API call and no credit consumption, which is a key behavioral trait. It also lists the detailed coverage of each action, giving a good sense of what the response will contain. While it doesn't describe response format or pagination, the tool is a simple reference lookup, so the disclosure is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is effectively structured with a leading one-line summary followed by a bulleted list of actions. Each bullet is concise and informative, with no redundant or filler content. It packs a lot of useful detail into a compact format, making it easy to scan and understand.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has a simple interface with only one required parameter, and the description covers all possible enum values with detailed context. It also conveys the crucial fact that no credits are consumed, which is important for cost-aware agents. No output schema exists, but the description clearly indicates what type of information is returned for each action, making the tool fully understandable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already provides 100% coverage with descriptions for both 'action' and 'context', so the baseline is 3. The tool description adds substantial meaning beyond the schema by detailing exactly what content each enum value provides (e.g., errors includes HTTP status, error code, message; callbacks includes retry strategy and HMAC). This goes above the schema's simple 'Reference topic to retrieve'.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'CryptoAPIs reference documentation — no API call, no credits consumed,' which precisely defines the tool as a documentation lookup rather than an operational API call. It then enumerates five distinct reference actions (blockchains, errors, credits, callbacks, limits), each accompanied by a brief scope. This clearly differentiates it from sibling fee-related tools like blockchain_fees_utxo/evm/xrp.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly notes that no API call or credits are consumed, signaling that this tool is for retrieving reference information, not for executing transactions. Each bullet item specifies the kind of information retrievable, such as error tables, credit costs, and webhook mechanics, giving implicit when-to-use guidance. It does not explicitly mention alternatives, but sibling tools are fee-specific, so the usage context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 4 tool updatesv0.3.0
    • First observedblockchain_fees_evm
    • First observedblockchain_fees_utxo
    • First observedblockchain_fees_xrp
    • First observedsystem_info

TDQS

A4/5.0
Disambiguation5/5

Each tool targets a distinct blockchain family (UTXO, EVM, XRP) or serves a clearly separate documentation purpose (system_info). There is no overlap or ambiguity between tool purposes.

Naming Consistency4/5

The three fee tools follow a consistent 'blockchain_fees_<type>' pattern, making their scope predictable. system_info deviates from the fee-focused naming but is a clear utility name, so the overall set is mostly consistent.

Tool Count5/5

Four tools is a well-scoped count for a fee-estimation server. Each tool handles a distinct category (UTXO, EVM, XRP, documentation) without unnecessary bloat or missing essentials.

Completeness4/5

The server covers the primary blockchain fee estimation families (UTXO, EVM, XRP) and includes detailed internal actions for each. Minor gaps exist for other fee types or chains, but the core domain is well covered.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/CryptoAPIs-io/cryptoapis-mcp-blockchain-fees'

If you have feedback or need assistance with the MCP directory API, please join our Discord server