koios-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOIOS_API_KEY | No | Optional Bearer token for higher rate limits | |
| KOIOS_NETWORK | No | Network to query: mainnet, preview, preprod, or guild | preview |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| koios_tipB | Get the current chain tip (latest block) of the Cardano blockchain |
| koios_era_summariesB | Get a summary of all eras on the Cardano blockchain |
| koios_genesisC | Get the genesis parameters of the Cardano blockchain |
| koios_totalsB | Get tokenomic statistics (supply, staking, treasury, reserves) per epoch |
| koios_param_updatesB | Get protocol parameter update proposals submitted on-chain |
| koios_cli_protocol_paramsC | Get the current protocol parameters in cardano-cli compatible format |
| koios_reserve_withdrawalsC | Get reserve withdrawals from the Cardano reserve |
| koios_treasury_withdrawalsB | Get treasury withdrawals from the Cardano treasury |
| koios_epoch_infoA | Get epoch-specific information including start/end times, block counts, and transaction counts |
| koios_epoch_paramsC | Get protocol parameters for a specific epoch |
| koios_epoch_block_protocolsB | Get the block protocol distribution for a specific epoch |
| koios_blocksB | Get a list of blocks, latest first, with pagination support |
| koios_block_infoB | Get detailed information about specific blocks by their hashes |
| koios_block_txsA | Get a list of all transactions included in specific blocks |
| koios_block_tx_cborC | Get raw CBOR-encoded transactions from specific blocks |
| koios_utxo_infoB | Get UTxO information for given UTxO references (tx_hash#tx_index format) |
| koios_tx_cborA | Get raw CBOR-encoded transactions by their hashes |
| koios_tx_infoB | Get detailed information about specific transactions including inputs, outputs, metadata, assets, etc. |
| koios_tx_metadataC | Get metadata for specific transactions |
| koios_tx_metalabelsC | Get a list of all transaction metadata labels |
| koios_tx_by_metalabelC | Get transactions by metadata label |
| koios_submittxA | Submit an already serialized transaction (CBOR-encoded hex string) to the Cardano network |
| koios_tx_statusA | Get the status (number of confirmations) of given transactions |
| koios_tx_outs_epochB | Get all transaction outputs for a specific epoch |
| koios_address_listB | Get a list of all addresses with their first appearance on the blockchain |
| koios_address_infoB | Get balance and staking information for given addresses |
| koios_address_utxosC | Get UTxO set for given addresses |
| koios_address_outputsA | Get transaction outputs for given addresses (including spent) |
| koios_credential_utxosB | Get UTxO set for given payment credentials |
| koios_address_txsB | Get transaction hashes for given addresses |
| koios_credential_txsA | Get transaction hashes for given payment credentials |
| koios_address_assetsC | Get native asset holdings for given addresses |
| koios_account_listA | Get a list of all stake accounts on the Cardano blockchain |
| koios_account_infoB | Get stake account information including balance, delegation, and rewards for given stake addresses |
| koios_account_info_cachedA | Get cached stake account information (faster but may be slightly stale) |
| koios_account_utxosC | Get UTxOs associated with given stake accounts |
| koios_account_txsC | Get transaction history for a specific stake account |
| koios_account_reward_historyC | Get reward history for given stake accounts |
| koios_account_updatesB | Get account registration/deregistration updates for given stake accounts |
| koios_account_update_historyC | Get full update history for given stake accounts |
| koios_account_addressesB | Get all payment addresses associated with given stake accounts |
| koios_account_assetsB | Get native asset holdings for given stake accounts |
| koios_account_stake_historyB | Get stake history (active stake per epoch) for given stake accounts |
| koios_asset_listC | Get a list of all native assets on the Cardano blockchain |
| koios_policy_asset_listB | Get a list of all assets minted under a given policy |
| koios_asset_token_registryB | Get asset information from the token registry (off-chain metadata) |
| koios_asset_infoC | Get detailed information about specific assets |
| koios_asset_utxosB | Get UTxOs containing specific assets |
| koios_asset_historyB | Get mint/burn history of a specific asset |
| koios_asset_addressesA | Get all addresses holding a specific asset |
| koios_asset_nft_addressB | Get the current address holding a specific NFT |
| koios_policy_asset_mintsA | Get all mint/burn events for assets under a specific policy |
| koios_asset_summaryB | Get a summary of a specific asset (total transactions, wallets, mints/burns) |
| koios_asset_txsC | Get transactions involving a specific asset |
| koios_pool_listB | Get a list of all registered stake pools |
| koios_pool_infoC | Get detailed information about specific stake pools |
| koios_pool_stake_snapshotB | Get stake snapshot for a specific pool (mark, set, go snapshots) |
| koios_pool_delegatorsB | Get current delegators for a specific pool |
| koios_pool_delegators_historyB | Get historical delegators for a specific pool |
| koios_pool_invalid_delegatorsB | Get invalid delegators for a specific pool |
| koios_pool_blocksB | Get blocks minted by a specific pool |
| koios_pool_owner_historyB | Get owner history for specific pools |
| koios_pool_historyC | Get historical performance data for a specific pool |
| koios_pool_updatesB | Get pool registration/update/retirement certificates |
| koios_pool_registrationsB | Get pool registrations for a specific epoch or all epochs |
| koios_pool_retirementsB | Get pool retirements for a specific epoch or all epochs |
| koios_pool_relaysB | Get a list of registered pool relays |
| koios_pool_groupsA | Get pool groups (pools sharing the same owner/reward accounts) |
| koios_pool_metadataC | Get metadata for specific stake pools |
| koios_pool_calidus_keysC | Get Calidus keys for stake pools |
| koios_pool_voting_power_historyC | Get voting power history for stake pools |
| koios_drep_epoch_summaryC | Get DRep epoch summary statistics |
| koios_drep_listB | Get a list of all registered DReps (Delegated Representatives) |
| koios_drep_infoC | Get detailed information about specific DReps |
| koios_drep_metadataC | Get metadata for specific DReps |
| koios_drep_updatesB | Get registration/update events for DReps |
| koios_drep_voting_power_historyB | Get voting power history for a specific DRep |
| koios_drep_delegatorsA | Get current delegators for a specific DRep |
| koios_committee_infoC | Get Constitutional Committee member information |
| koios_committee_votesB | Get Constitutional Committee votes on governance proposals |
| koios_proposal_listA | Get a list of all governance proposals |
| koios_voter_proposal_listB | Get governance proposals relevant to a specific voter |
| koios_proposal_voting_summaryC | Get voting summary for a specific governance proposal |
| koios_proposal_votesB | Get all votes cast on a specific governance proposal |
| koios_vote_listC | Get a list of all governance votes |
| koios_script_infoB | Get information about specific scripts by their hashes |
| koios_native_script_listA | Get a list of all native (non-Plutus) scripts on the blockchain |
| koios_plutus_script_listB | Get a list of all Plutus scripts on the blockchain |
| koios_script_redeemersB | Get redeemer information for a specific script |
| koios_reference_script_utxosA | Get UTxOs containing reference scripts for given script hashes |
| koios_datum_infoA | Get datum information for given datum hashes |
| koios_ogmiosA | Send a JSON-RPC request to the Ogmios endpoint via Koios (supports Ogmios methods like queryLedgerState, queryNetwork, etc.) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 92 tools
The tools are grouped by domain and mostly have distinct purposes, but the sheer number of similar resources (e.g., koios_account_updates vs koios_account_update_history, koios_pool_registrations vs koios_pool_updates) creates potential confusion. Descriptions help, but boundaries between some tools are subtle.
All tools consistently use the 'koios_' prefix with snake_case, and most follow a resource_qualifier pattern (e.g., koios_epoch_info, koios_block_txs). Minor deviations like koios_ogmios and embedded abbreviations (cli, cbor) prevent a perfect score.
With 92 tools, the server is far beyond the typical well-scoped MCP range. While the Koios API is broad, exposing every endpoint as a separate tool makes the surface unwieldy and overwhelming for agents.
The toolset offers comprehensive coverage of the Cardano blockchain, including chain status, epochs, blocks, transactions, addresses, accounts, assets, pools, governance, scripts, and even transaction submission. No significant gaps are apparent.