Which integrations are available for this server?

Provides tools to interact with a Cardano node via cardano-cli/torsten-cli, enabling querying, transaction building, address/key management, stake operations, pool management, and governance actions.

How do I use cardano-node-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@cardano-node-mcp what is the current chain tip?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

cardano-node-mcp

by michaeljfazio

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

cardano-node-mcp-server

An MCP (Model Context Protocol) server that enables LLMs to interact with a Cardano node by wrapping the cardano-cli / torsten-cli command-line interface. Compatible with both the Haskell cardano-node and Torsten implementations.

Features

64 tools covering the full cardano-cli surface area
Query — chain tip, UTxOs, protocol parameters, stake distribution, governance state, mempool, treasury, constitution, and more
Transaction — build, sign, submit, view, witness, assemble, calculate fees, compute policy IDs
Address & Key — generate key pairs, build addresses, compute key hashes
Stake — registration, delegation, vote delegation certificates
Stake Pool — key generation, registration/retirement certificates, operational certificates
Governance — DRep management, voting, governance actions (info, no-confidence, constitution, hard fork, protocol parameter updates, committee updates, treasury withdrawals)
Node — cold/KES/VRF key generation, operational certificates

Related MCP server: SnapKitty MCP Server

Prerequisites

Node.js ≥ 18
A Cardano CLI binary — either cardano-cli or torsten-cli
A running Cardano node with an accessible Unix domain socket

Installation

git clone https://github.com/michaeljfazio/cardano-node-mcp.git
cd cardano-node-mcp
npm install
npm run build

Configuration

The server is configured via environment variables:

Variable	Default	Description
`CARDANO_CLI_PATH`	`cardano-cli`	Path to the CLI binary. Set to `torsten-cli` for Torsten nodes.
`CARDANO_NODE_SOCKET_PATH`	`node.sock`	Path to the cardano-node Unix domain socket.
`CARDANO_TESTNET_MAGIC`	(unset = mainnet)	Testnet magic number (e.g., `1` for preprod, `2` for preview).

Usage

Claude Code

Add to your Claude Code MCP configuration (~/.claude/mcp.json):

{
  "mcpServers": {
    "cardano-node": {
      "command": "node",
      "args": ["/path/to/cardano-node-mcp/dist/index.js"],
      "env": {
        "CARDANO_CLI_PATH": "cardano-cli",
        "CARDANO_NODE_SOCKET_PATH": "/path/to/node.sock"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "cardano-node": {
      "command": "node",
      "args": ["/path/to/cardano-node-mcp/dist/index.js"],
      "env": {
        "CARDANO_CLI_PATH": "cardano-cli",
        "CARDANO_NODE_SOCKET_PATH": "/path/to/node.sock"
      }
    }
  }
}

Development

npm run dev    # Run with auto-reload via tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server

Tools Reference

See docs/tools.md for a complete reference of all 64 tools with their parameters.

Architecture

The server uses a simple architecture:

LLM ↔ MCP (stdio) ↔ cardano-node-mcp-server ↔ cardano-cli/torsten-cli ↔ cardano-node (Unix socket)

Each MCP tool maps to a CLI subcommand. The server:

Validates input parameters via Zod schemas
Constructs CLI arguments
Executes the CLI binary with CARDANO_NODE_SOCKET_PATH set
Returns stdout as the tool result (or a structured error)

Network and socket configuration are applied globally from environment variables, so individual tool calls don't need to specify them.

License

MIT

Available Tools

64 tools

cardano_address_buildBuild AddressB

Idempotent

Build a Cardano address from verification keys.

Args:

payment_verification_key_file (string): Path to payment verification key file
stake_verification_key_file (string, optional): Path to stake verification key file (for base addresses)
out_file (string, optional): File path to write the address to

Returns: The bech32 address.

Inputs: payment_verification_key_file (required), out_file, stake_verification_key_file.

cardano_address_infoAddress InfoC

Read-onlyIdempotent

Decode and display information about a Cardano address.

Args:

address (string): Bech32-encoded Cardano address

Returns: Address type, network, and credential information.

Inputs: address (required).

cardano_address_key_genGenerate Address Key PairB

Generate a payment address key pair (verification key and signing key).

Args:

verification_key_file (string): Output path for the verification key
signing_key_file (string): Output path for the signing key

Returns: Confirmation that keys were generated.

Inputs: signing_key_file (required), verification_key_file (required).

cardano_address_key_hashGet Address Key HashB

Read-onlyIdempotent

Get the hash of a payment verification key.

Args:

payment_verification_key_file (string): Path to the payment verification key file

Returns: The key hash as hex string.

Inputs: payment_verification_key_file (required).

cardano_governance_action_create_constitutionCreate Constitution ActionB

Idempotent

Create a new constitution governance action.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
constitution_url (string): Constitution document URL
constitution_hash (string): Constitution document hash
constitution_script_hash (string, optional): Guardian script hash
prev_governance_action_tx_id (string, optional): Previous action tx ID
prev_governance_action_index (number, optional): Previous action index
out_file (string): Output path

Inputs: deposit (required), out_file (required), anchor_url (required), return_addr (required), +6 more.

cardano_governance_action_create_hard_forkCreate Hard Fork Initiation ActionC

Idempotent

Create a hard fork initiation governance action.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
protocol_major_version (number): Target major protocol version
protocol_minor_version (number): Target minor protocol version
prev_governance_action_tx_id (string, optional): Previous action tx ID
prev_governance_action_index (number, optional): Previous action index
out_file (string): Output path

Inputs: deposit (required), out_file (required), anchor_url (required), return_addr (required), +5 more.

cardano_governance_action_create_infoCreate Info Governance ActionA

Idempotent

Create an informational governance action (no on-chain effect, used for signaling).

Args:

anchor_url (string): Anchor URL for the action metadata
anchor_data_hash (string): Anchor data hash
deposit (number): Governance action deposit in lovelace
return_addr (string): Bech32 stake address for deposit return
out_file (string): Output path for the action file

Inputs: deposit (required), out_file (required), anchor_url (required), return_addr (required), +1 more.

cardano_governance_action_create_no_confidenceCreate No Confidence ActionB

Idempotent

Create a motion of no confidence in the current constitutional committee.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
prev_governance_action_tx_id (string, optional): Previous governance action tx ID
prev_governance_action_index (number, optional): Previous governance action index
out_file (string): Output path

Inputs: deposit (required), out_file (required), anchor_url (required), return_addr (required), +3 more.

cardano_governance_action_create_protocol_params_updateCreate Protocol Parameters Update ActionC

Idempotent

Create a governance action to update protocol parameters.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
protocol_parameters_update (string): Path to JSON file with parameter updates
constitution_script_hash (string, optional): Guardian script hash
prev_governance_action_tx_id (string, optional): Previous action tx ID
prev_governance_action_index (number, optional): Previous action index
out_file (string): Output path

Inputs: deposit (required), out_file (required), anchor_url (required), return_addr (required), +5 more.

cardano_governance_action_create_treasury_withdrawalCreate Treasury Withdrawal ActionB

Idempotent

Create a governance action to withdraw funds from the treasury.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
funds_receiving_stake_verification_key_file (string): Path to stake verification key of funds recipient
transfer (number): Amount to withdraw in lovelace
out_file (string): Output path

Inputs: deposit (required), out_file (required), transfer (required), anchor_url (required), +3 more.

cardano_governance_action_create_update_committeeCreate Update Committee ActionC

Idempotent

Create a governance action to update the constitutional committee.

Args:

anchor_url (string): Anchor URL
anchor_data_hash (string): Anchor data hash
deposit (number): Deposit in lovelace
return_addr (string): Stake address for deposit return
threshold (string): Quorum threshold as "numerator/denominator"
remove_cc_cold_verification_key_hashes (string[], optional): CC member key hashes to remove
add_cc_cold_verification_key_hashes (string[], optional): CC members to add as "key_hash,expiry_epoch"
prev_governance_action_tx_id (string, optional): Previous action tx ID
prev_governance_action_index (number, optional): Previous action index
out_file (string): Output path

Inputs: deposit (required), out_file (required), threshold (required), anchor_url (required), +6 more.

cardano_governance_action_hash_anchor_dataHash Anchor DataA

Read-onlyIdempotent

Compute the hash of anchor data from a file.

Args:

file_binary (string, optional): Path to binary file to hash
file_text (string, optional): Path to text file to hash

Exactly one of file_binary or file_text must be provided.

Returns: The blake2b-256 hash of the file contents.

Inputs: file_text, file_binary.

cardano_governance_drep_idGet DRep IDB

Read-onlyIdempotent

Get the DRep ID from a verification key file.

Args:

drep_verification_key_file (string): Path to DRep verification key file
output_format (string, optional): Output format: "bech32" (default) or "hex"

Returns: The DRep ID.

Inputs: drep_verification_key_file (required), output_format.

cardano_governance_drep_key_genGenerate DRep Key PairB

Generate a DRep (Delegated Representative) key pair.

Args:

verification_key_file (string): Output path for the verification key
signing_key_file (string): Output path for the signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_governance_drep_registration_certificateCreate DRep Registration CertificateC

Idempotent

Create a DRep registration certificate.

Args:

drep_verification_key_file (string): Path to DRep verification key file
key_reg_deposit_amt (number): Registration deposit in lovelace
anchor_url (string, optional): DRep metadata anchor URL
anchor_data_hash (string, optional): DRep metadata anchor data hash
out_file (string): Output path for the certificate

Inputs: out_file (required), key_reg_deposit_amt (required), drep_verification_key_file (required), anchor_url, +1 more.

cardano_governance_drep_retirement_certificateCreate DRep Retirement CertificateB

DestructiveIdempotent

Create a DRep retirement certificate.

Args:

drep_verification_key_file (string): Path to DRep verification key file
deposit_amt (number): Deposit refund amount in lovelace
out_file (string): Output path for the certificate

Inputs: out_file (required), deposit_amt (required), drep_verification_key_file (required).

cardano_governance_drep_update_certificateCreate DRep Update CertificateC

Idempotent

Create a DRep update certificate to update anchor metadata.

Args:

drep_verification_key_file (string): Path to DRep verification key file
anchor_url (string, optional): Updated anchor URL
anchor_data_hash (string, optional): Updated anchor data hash
out_file (string): Output path for the certificate

Inputs: out_file (required), drep_verification_key_file (required), anchor_url, anchor_data_hash.

cardano_governance_vote_createCreate Governance VoteA

Idempotent

Create a governance vote file for a governance action.

Args:

governance_action_tx_id (string): Transaction ID of the governance action
governance_action_index (number): Index of the governance action in the transaction
vote (string): Vote choice: "yes", "no", or "abstain"
drep_verification_key_file (string, optional): Path to DRep verification key (for DRep voter)
cold_verification_key_file (string, optional): Path to cold verification key (for SPO voter)
cc_hot_verification_key_file (string, optional): Path to CC hot verification key (for CC voter)
anchor_url (string, optional): Vote rationale anchor URL
anchor_data_hash (string, optional): Vote rationale anchor data hash
out_file (string): Output path for the vote file

Exactly one voter key file must be provided (DRep, SPO, or CC).

Inputs: vote (required), out_file (required), governance_action_index (required), governance_action_tx_id (required), +5 more.

cardano_key_generate_paymentGenerate Payment Key PairC

Generate a payment signing and verification key pair.

Args:

signing_key_file (string): Output path for the signing key
verification_key_file (string): Output path for the verification key

Returns: Confirmation that keys were generated.

Inputs: signing_key_file (required), verification_key_file (required).

cardano_key_generate_stakeGenerate Stake Key PairB

Generate a stake signing and verification key pair.

Args:

signing_key_file (string): Output path for the signing key
verification_key_file (string): Output path for the verification key

Returns: Confirmation that keys were generated.

Inputs: signing_key_file (required), verification_key_file (required).

cardano_key_verification_hashGet Verification Key HashB

Read-onlyIdempotent

Get the hash of a verification key.

Args:

verification_key_file (string): Path to the verification key file

Returns: The key hash as hex string.

Inputs: verification_key_file (required).

cardano_node_issue_op_certIssue Node Operational CertificateC

Issue an operational certificate for a block-producing node.

Args:

kes_verification_key_file (string): Path to KES verification key file
cold_signing_key_file (string): Path to cold signing key file
operational_certificate_counter_file (string): Path to op cert counter file
kes_period (number): Current KES period
out_file (string): Output path for the operational certificate

Inputs: out_file (required), kes_period (required), cold_signing_key_file (required), kes_verification_key_file (required), +1 more.

cardano_node_key_genGenerate Node Cold KeysB

Generate node cold key pair and operational certificate counter.

Args:

cold_verification_key_file (string): Output path for the cold verification key
cold_signing_key_file (string): Output path for the cold signing key
operational_certificate_counter_file (string): Output path for the op cert counter

Inputs: cold_signing_key_file (required), cold_verification_key_file (required), operational_certificate_counter_file (required).

cardano_node_key_gen_kesGenerate Node KES KeysB

Generate KES (Key Evolving Signature) key pair for a block-producing node.

Args:

verification_key_file (string): Output path for the KES verification key
signing_key_file (string): Output path for the KES signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_node_key_gen_vrfGenerate Node VRF KeysB

Generate VRF (Verifiable Random Function) key pair for a block-producing node.

Args:

verification_key_file (string): Output path for the VRF verification key
signing_key_file (string): Output path for the VRF signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_node_new_counterCreate New Op Cert CounterB

Idempotent

Create a new operational certificate counter with a specified value.

Args:

cold_verification_key_file (string): Path to cold verification key file
counter_value (number): Counter value to set
operational_certificate_counter_file (string): Output path for the counter file

Inputs: counter_value (required), cold_verification_key_file (required), operational_certificate_counter_file (required).

cardano_query_committee_stateQuery Committee StateB

Read-onlyIdempotent

Query the current constitutional committee state.

Inputs: no named parameters.

cardano_query_constitutionQuery ConstitutionB

Read-onlyIdempotent

Query the current on-chain constitution.

Inputs: no named parameters.

cardano_query_drep_stateQuery DRep StateB

Read-onlyIdempotent

Query DRep (Delegated Representative) state. Optionally filter by DRep key hash.

Args:

drep_key_hash (string, optional): Hex-encoded DRep key hash to filter by

Returns: DRep state information.

Inputs: drep_key_hash.

cardano_query_gov_stateQuery Governance StateB

Read-onlyIdempotent

Query the current governance state including proposals, DReps, and committee info.

Inputs: no named parameters.

cardano_query_leadership_scheduleQuery Leadership ScheduleA

Read-onlyIdempotent

Calculate the leadership schedule for a stake pool operator.

Args:

vrf_signing_key_file (string): Path to VRF signing key file
epoch_nonce (string): 64-character hex epoch nonce
epoch_start_slot (number): Slot number at the start of the epoch
epoch_length (number, optional): Epoch length in slots (default: 432000)
relative_stake (number): Pool's relative stake as a decimal (e.g., 0.001)
active_slot_coeff (number, optional): Active slot coefficient (default: 0.05)

Returns: List of slots where the pool is elected to produce blocks.

Inputs: epoch_nonce (required), relative_stake (required), epoch_start_slot (required), vrf_signing_key_file (required), +2 more.

cardano_query_pool_paramsQuery Pool ParametersB

Read-onlyIdempotent

Query stake pool parameters. Optionally filter by stake pool ID.

Args:

stake_pool_id (string, optional): Bech32 or hex stake pool ID

Returns: Pool parameter details.

Inputs: stake_pool_id.

cardano_query_protocol_parametersQuery Protocol ParametersB

Read-onlyIdempotent

Query current protocol parameters. Optionally write to a file for use in transaction fee calculation.

Args:

out_file (string, optional): File path to write protocol parameters JSON to

Returns: Protocol parameters as JSON.

Inputs: out_file.

cardano_query_ratify_stateQuery Ratification StateC

Read-onlyIdempotent

Query the current governance ratification state.

Inputs: no named parameters.

cardano_query_stake_address_infoQuery Stake Address InfoB

Read-onlyIdempotent

Query information about a stake address including delegation and rewards.

Args:

address (string): Bech32 stake address to query

Returns: Stake address info including delegation and reward balance.

Inputs: address (required).

cardano_query_stake_distributionQuery Stake DistributionB

Read-onlyIdempotent

Query the current stake distribution across all stake pools.

Inputs: no named parameters.

cardano_query_stake_poolsQuery Stake PoolsA

Read-onlyIdempotent

Query all registered stake pool IDs.

Inputs: no named parameters.

cardano_query_stake_snapshotQuery Stake SnapshotB

Read-onlyIdempotent

Query stake snapshots (mark, set, go). Optionally filter by stake pool ID.

Args:

stake_pool_id (string, optional): Bech32 or hex stake pool ID

Returns: Stake snapshot data.

Inputs: stake_pool_id.

cardano_query_tipQuery Chain TipA

Read-onlyIdempotent

Query the current tip of the blockchain including slot, block number, epoch, and sync progress.

Inputs: no named parameters.

cardano_query_treasuryQuery TreasuryA

Read-onlyIdempotent

Query the current treasury and reserves balances.

Inputs: no named parameters.

cardano_query_tx_mempoolQuery Transaction MempoolA

Read-onlyIdempotent

Query the transaction mempool. Supports three subcommands: info (mempool stats), next-tx (next transaction), has-tx (check if a specific tx is in mempool).

Args:

subcmd (string): One of "info", "next-tx", "has-tx" (default: "info")
tx_id (string, optional): Transaction ID hash for has-tx subcommand

Returns: Mempool information based on subcommand.

Inputs: tx_id, subcmd.

cardano_query_utxoQuery UTxOA

Read-onlyIdempotent

Query UTxO entries. Filter by address and/or specific transaction inputs.

Args:

address (string, optional): Bech32 address to query UTxOs for
tx_ins (string[], optional): Specific UTxO references in format "tx_hash#index"

At least one of address or tx_ins must be provided.

Returns: UTxO set as formatted text.

Inputs: tx_ins, address.

cardano_stake_address_buildBuild Stake AddressB

Idempotent

Build a stake address from a stake verification key.

Args:

stake_verification_key_file (string): Path to stake verification key file
out_file (string, optional): File path to write the address to

Returns: The bech32 stake address.

Inputs: stake_verification_key_file (required), out_file.

cardano_stake_address_delegation_certificateCreate Delegation CertificateB

Idempotent

Create a stake delegation certificate to delegate to a stake pool.

Args:

stake_verification_key_file (string): Path to stake verification key file
stake_pool_id (string): Bech32 or hex stake pool ID to delegate to
out_file (string): Output path for the certificate file

Inputs: out_file (required), stake_pool_id (required), stake_verification_key_file (required).

cardano_stake_address_deregistration_certificateCreate Stake Deregistration CertificateB

DestructiveIdempotent

Create a stake address deregistration certificate.

Args:

stake_verification_key_file (string): Path to stake verification key file
key_reg_deposit_amt (number, optional): Key registration deposit amount in lovelace (Conway era)
out_file (string): Output path for the certificate file

Inputs: out_file (required), stake_verification_key_file (required), key_reg_deposit_amt.

cardano_stake_address_key_genGenerate Stake Address Key PairC

Generate a stake address key pair.

Args:

verification_key_file (string): Output path for the verification key
signing_key_file (string): Output path for the signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_stake_address_registration_certificateCreate Stake Registration CertificateC

Idempotent

Create a stake address registration certificate.

Args:

stake_verification_key_file (string): Path to stake verification key file
key_reg_deposit_amt (number, optional): Key registration deposit amount in lovelace (Conway era)
out_file (string): Output path for the certificate file

Inputs: out_file (required), stake_verification_key_file (required), key_reg_deposit_amt.

cardano_stake_address_vote_delegation_certificateCreate Vote Delegation CertificateB

Idempotent

Create a vote delegation certificate to delegate voting power to a DRep, or to always abstain/no-confidence.

Args:

stake_verification_key_file (string): Path to stake verification key file
drep_verification_key_file (string, optional): Path to DRep verification key file
always_abstain (boolean, optional): Delegate to always-abstain
always_no_confidence (boolean, optional): Delegate to always-no-confidence
out_file (string): Output path for the certificate file

Exactly one of drep_verification_key_file, always_abstain, or always_no_confidence must be provided.

Inputs: out_file (required), stake_verification_key_file (required), always_abstain, always_no_confidence, +1 more.

cardano_stake_pool_idGet Stake Pool IDA

Read-onlyIdempotent

Get the pool ID from a cold verification key.

Args:

cold_verification_key_file (string): Path to the cold verification key file

Returns: The pool ID as bech32 string.

Inputs: cold_verification_key_file (required).

cardano_stake_pool_issue_op_certIssue Operational CertificateC

Issue an operational certificate for a stake pool.

Args:

kes_verification_key_file (string): Path to KES verification key file
cold_signing_key_file (string): Path to cold signing key file
operational_certificate_counter_file (string): Path to op cert counter file
kes_period (number): Current KES period
out_file (string): Output path for the operational certificate

Inputs: out_file (required), kes_period (required), cold_signing_key_file (required), kes_verification_key_file (required), +1 more.

cardano_stake_pool_kes_key_genGenerate KES Key PairC

Generate a KES (Key Evolving Signature) key pair for a stake pool.

Args:

verification_key_file (string): Output path for the KES verification key
signing_key_file (string): Output path for the KES signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_stake_pool_key_genGenerate Stake Pool KeysC

Generate stake pool cold key pair and operational certificate counter.

Args:

cold_verification_key_file (string): Output path for the cold verification key
cold_signing_key_file (string): Output path for the cold signing key
operational_certificate_counter_file (string): Output path for the op cert counter

Inputs: cold_signing_key_file (required), cold_verification_key_file (required), operational_certificate_counter_file (required).

cardano_stake_pool_registration_certificateCreate Pool Registration CertificateB

Idempotent

Create a stake pool registration certificate with full pool parameters.

Args:

cold_verification_key_file (string): Path to cold verification key file
vrf_verification_key_file (string): Path to VRF verification key file
pledge (number): Pledge amount in lovelace
cost (number): Fixed cost per epoch in lovelace
margin (number): Pool margin (0.0 to 1.0)
reward_account_verification_key_file (string): Path to reward account verification key
pool_owner_verification_key_files (string[]): Paths to pool owner verification keys
pool_relay_ipv4 (string[], optional): IPv4 relays in format "IP:port"
single_host_pool_relay (string[], optional): DNS relays in format "hostname:port"
multi_host_pool_relay (string[], optional): Multi-host DNS relays
metadata_url (string, optional): Pool metadata URL
metadata_hash (string, optional): Pool metadata hash (hex)
out_file (string): Output path for the certificate file

Inputs: cost (required), margin (required), pledge (required), out_file (required), +9 more.

cardano_stake_pool_retirement_certificateCreate Pool Retirement CertificateC

DestructiveIdempotent

Create a stake pool retirement certificate.

Args:

cold_verification_key_file (string): Path to cold verification key file
epoch (number): Epoch in which the pool will be retired
out_file (string): Output path for the certificate file

Inputs: epoch (required), out_file (required), cold_verification_key_file (required).

cardano_stake_pool_vrf_key_genGenerate VRF Key PairC

Generate a VRF (Verifiable Random Function) key pair for a stake pool.

Args:

verification_key_file (string): Output path for the VRF verification key
signing_key_file (string): Output path for the VRF signing key

Inputs: signing_key_file (required), verification_key_file (required).

cardano_transaction_assembleAssemble TransactionC

Idempotent

Assemble a transaction from a body and witness files.

Args:

tx_body_file (string): Path to the transaction body file
witness_files (string[]): Paths to witness files
out_file (string): Output path for the assembled signed transaction

Returns: Confirmation that transaction was assembled.

Inputs: out_file (required), tx_body_file (required), witness_files (required).

cardano_transaction_buildBuild TransactionA

Idempotent

Build a transaction body. Supports inputs, outputs, change address, fees, TTL, certificates, withdrawals, metadata, collateral, required signers, and minting.

Args:

tx_ins (string[]): Transaction inputs in format "tx_hash#index"
tx_outs (string[]): Transaction outputs in format "address+amount" (amount in lovelace, or "address+amount+multi_asset")
change_address (string, optional): Address to send change to (required for auto-balancing)
fee (number, optional): Transaction fee in lovelace (if omitted, auto-calculated when change_address provided)
ttl (number, optional): Transaction time-to-live (slot number)
certificate_files (string[], optional): Paths to certificate files to include
withdrawals (string[], optional): Stake withdrawals in format "stake_address+amount"
metadata_json_file (string, optional): Path to metadata JSON file
tx_in_collateral (string[], optional): Collateral inputs in format "tx_hash#index"
required_signer_hashes (string[], optional): Required signer key hashes
mint (string[], optional): Minting operations in format "policy_id.asset_name+/-quantity"
out_file (string): Output path for the transaction body file

Returns: Confirmation with estimated fee (if auto-calculated).

Inputs: tx_ins (required), tx_outs (required), out_file (required), fee, +8 more.

cardano_transaction_calculate_min_feeCalculate Minimum FeeA

Read-onlyIdempotent

Calculate the minimum fee for a transaction.

Args:

tx_body_file (string): Path to the transaction body file
witness_count (number, optional): Number of witnesses (default: 1)
protocol_params_file (string): Path to protocol parameters JSON file

Returns: The minimum fee in lovelace.

Inputs: tx_body_file (required), protocol_params_file (required), witness_count.

cardano_transaction_policyidGet Policy IDB

Read-onlyIdempotent

Compute the policy ID from a minting policy script file.

Args:

script_file (string): Path to the minting policy script file

Returns: The policy ID as hex string.

Inputs: script_file (required).

cardano_transaction_signSign TransactionC

Idempotent

Sign a transaction body with one or more signing keys.

Args:

tx_body_file (string): Path to the transaction body file
signing_key_files (string[]): Paths to signing key files
out_file (string): Output path for the signed transaction

Returns: Confirmation that transaction was signed.

Inputs: out_file (required), tx_body_file (required), signing_key_files (required).

cardano_transaction_submitSubmit TransactionB

Destructive

Submit a signed transaction to the blockchain via the node.

Args:

tx_file (string): Path to the signed transaction file

Returns: Confirmation that the transaction was submitted, or validation error details.

Inputs: tx_file (required).

cardano_transaction_txidGet Transaction IDA

Read-onlyIdempotent

Get the transaction ID (hash) from a transaction file.

Args:

tx_file (string): Path to the transaction file (signed or unsigned)

Returns: The transaction ID as hex string.

Inputs: tx_file (required).

cardano_transaction_viewView TransactionB

Read-onlyIdempotent

Display the contents of a transaction file in human-readable format.

Args:

tx_file (string): Path to the transaction file

Returns: Transaction details.

Inputs: tx_file (required).

cardano_transaction_witnessCreate Transaction WitnessB

Idempotent

Create a witness for a transaction body using a signing key.

Args:

tx_body_file (string): Path to the transaction body file
signing_key_file (string): Path to the signing key file
out_file (string): Output path for the witness file

Returns: Confirmation that witness was created.

Inputs: out_file (required), tx_body_file (required), signing_key_file (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.9/5.0

Scored 2026-09-13 13:03 across 64 tools

Disambiguation2/5

Several tool pairs appear to perform identical or near-identical operations, such as cardano_address_key_gen vs cardano_key_generate_payment, cardano_stake_address_key_gen vs cardano_key_generate_stake, and the stake-pool/node key duplication (e.g., cardano_stake_pool_key_gen vs cardano_node_key_gen). While many query and governance tools are distinct, these overlapping boundaries make misselection likely.

Naming Consistency3/5

All names use snake_case with a cardano_ prefix, but ordering conventions are inconsistent: some use domain_action (cardano_transaction_build), others use action_domain (cardano_key_generate_payment), and some duplicate concepts use different patterns. The names are still mostly readable, but the mixed verb/noun ordering reduces predictability.

Tool Count2/5

64 tools is far beyond the typical 3-15 range and includes many redundant or alias-like commands that could be consolidated. The Cardano node domain is broad, so some scale is justified, but the set feels heavy and over-provisioned for a single MCP server.

Completeness4/5

The surface covers a wide range of Cardano node operations: queries, address/key generation, transaction lifecycle, stake address/pool management, governance actions, and DRep operations. Only minor gaps or redundancies are present, so agents can accomplish most intended workflows.

Resources

Related MCP Connectors

mcpA
com.everstake
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Blockchain Cryptocurrency
1111
https://mcp.everstake.com
mcpA
io.scorecard
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
RAG Systems Monitoring Testing & QA Tools
3
https://mcp.scorecard.io/mcp
tenzro
xyz.tenzro
Tenzro Network MCP server: wallet, identity, payments, inference, staking, bridges, verification.
Blockchain Cryptocurrency Payments & Billing
2
https://mcp.tenzro.xyz/mcp
jumpcloud-genai
com.jumpcloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Cloud Platforms Security Developer Tools
2
https://mcp.jumpcloud.com/v1

Related MCP Servers

IndigoProtocol/cardano-mcp
Blockchain Web3 & Decentralized Tech Finance
IndigoProtocol
A
license
Not graded
quality
D
maintenance
MCP server for Cardano blockchain data — exposes on-chain queries, address lookups, transaction history, token metadata, stake pool info, and network parameters to LLM agents.
Updated 18 days ago (2026-10-27 12:05 UTC)
150 npm
4
MIT
SnapKitty MCP Serverofficial
Blockchain AI & Machine Learning Autonomous Agents
SNAPKITTYWEST
A
license
A
quality
D
maintenance
MCP server exposing tools for WORM chain sealing, sovereign agent creation, Ada governance contract generation, and SSM state injection from Lean theorems.
Updated 4 months ago (2026-07-04 20:08 UTC)
6
4
Apache 2.0
koios-mcp
Blockchain Cryptocurrency Web3 & Decentralized Tech
michaeljfazio
F
license
B
quality
D
maintenance
An MCP server that provides LLMs with access to 95 tools covering the Koios Cardano blockchain REST API, enabling queries for on-chain data like transactions, addresses, assets, and governance.
Updated 8 months ago (2026-03-10 12:24 UTC)
92
3
-
fund402-mcp
Blockchain Cryptocurrency
nickthelegend
A
license
Not graded
quality
D
maintenance
MCP server that exposes Fund402 protocol tools to Casper testnet, allowing LLMs to execute real on-chain actions like wallet creation, token management, and borrowing via natural language.
Updated 4 months ago (2026-07-08 10:01 UTC)
Apache 2.0

cardano-node-mcp-server

Features

Prerequisites

Installation

Configuration

Usage

Claude Code

Claude Desktop

Development

Tools Reference

Architecture

License

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

IndigoProtocol/cardano-mcp

SnapKitty MCP Serverofficial

koios-mcp

fund402-mcp