Algorand MCP Server

Overview

The Algorand MCP Server provides a comprehensive set of tools and resources for interacting with the Algorand blockchain through the Model Context Protocol (MCP). Running exclusively in Node.js environments, it enables seamless blockchain interactions with built-in support for account management, asset operations, application interactions, and blockchain queries.

Requirements

• Node.js v23.6.1 or later
• npm v10.2.4 or later

Features

• 125 total tools:
  • 40 base tools (account, asset, application, transaction management)
  • 30 API tools (algod and indexer)
  • 6 NFDomains (NFD) tools for name services
  • 28 Vestige tools for DeFi analytics
  • 9 Tinyman tools for AMM interactions
  • 12 Ultrade tools for DEX functionality
• 30 resource endpoints for data access
• Built-in default configuration for quick setup
• Comprehensive transaction management
• Complete application lifecycle support
• Asset creation and management
• Real-time and historical data access
• NFDomains integration for name resolution and management
• Vestige integration for DeFi analytics and tracking (optional, disabled by default)
• Tinyman AMM integration for decentralized trading (optional, disabled by default)
• Ultrade DEX integration for trading and market operations (optional, disabled by default)

Project Structure

src/
├── resources/                # MCP Resources (User-invokable endpoints)
│   ├── knowledge/           # Documentation and taxonomy
│   │   ├── taxonomy/        # Markdown documentation
│   │   ├── taxonomy-categories/ # Category JSON definitions
│   │   └── index.ts         # Knowledge resource handler
│   ├── wallet/             # Wallet management
│   │   └── index.ts         # Wallet resource handler
│   └── index.ts             # Resource registration
├── tools/                  # MCP Tools (Agent-invokable operations)
│   ├── accountManager.ts    # Account operations
│   ├── algodManager.ts      # Node interactions
│   ├── utilityManager.ts    # Utility functions
│   ├── apiManager/      # API Tools (Agent-accessible resource data)
│   │   ├── algod/          # Algod API tools
│   │   ├── indexer/        # Indexer API tools
│   │   ├── nfd/            # NFDomains tools
│   │   ├── vestige/        # Vestige DeFi tools
│   │   ├── tinyman/        # Tinyman AMM tools
│   │   └── ultrade/        # Ultrade DEX tools
│   └── transactionManager/ # Transaction handling
└── index.ts               # Server entry point

MCP Components

Resources

User-invokable endpoints that provide direct access to data and services:

1. Knowledge Resources:
   • algorand://knowledge/taxonomy - Full documentation taxonomy
   • algorand://knowledge/taxonomy/{category} - Category-specific documentation

Knowledge Tool:

• get_knowledge_doc - Get markdown content for specified knowledge documents
  • Parameters: { documents: string[] } (e.g., ["ARCs:specs:arc-0020.md"])
  • Returns: Document content in markdown format

1. Wallet Resources:
   • algorand://wallet/account - Account information and balances
   • algorand://wallet/assets - Account Asset holdings and details

API Tools

Agent-invokable tools that provide direct access to various Algorand ecosystem APIs. These tools are designed to be used by Agent LLMs to interact with:

• Algorand Node (algod) API for real-time blockchain data
• Indexer API for historical blockchain data
• NFDomains API for name services
• Vestige API for DeFi analytics
• Tinyman API for AMM operations
• Ultrade API for DEX functionality

Each API tool follows a consistent naming convention with the api_ prefix for clarity and better UX.

Installation

To install or update the Algorand MCP implementation, clone the repository, install the dependencies and build the project":

First check node version to be 23.6.1 or later:

node -v

Upgrade to 23.6.1 or later if needed!

Then check the Claude or Cursor container folders to have mcp-servers folder (if not create one):

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

Then clone this repository under mcp-servers folder and install dependencies:

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/algorand-mcp.git
cd algorand-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations

And you are done! Now you can open you MCP config and add the server as :

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
     ],
      "env": {
        "ALGORAND_NETWORK": "testnet",
        "ALGORAND_ALGOD_API": "https://testnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://testnet-api.algonode.cloud",
        "ALGORAND_INDEXER_API": "https://testnet-idx.algonode.cloud/v2",
        "ALGORAND_INDEXER": "https://testnet-idx.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_INDEXER_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "NFD_API_URL": "https://api.nf.domains",
        "NFD_API_KEY": "",
        "TINYMAN_ACTIVE": "false",
        "ULTRADE_ACTIVE": "false",
        "ULTRADE_API_URL": "https://api.ultrade.io",
        "VESTIGE_ACTIVE": "false",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "ITEMS_PER_PAGE": "10"

      }
    }
  }
}

Make sure yopu change the paths to match your local system's paths.

For example on MACOS and Claud, the path would be something like this:

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
     ]
    }
  }
}

Available Tools

Knowledge Resources

Static URIs for accessing Algorand's comprehensive documentation:

• algorand://knowledge/taxonomy - Full documentation taxonomy
• algorand://knowledge/taxonomy/arcs - ARCs documentation
• algorand://knowledge/taxonomy/sdks - SDKs documentation
• algorand://knowledge/taxonomy/algokit - AlgoKit documentation
• algorand://knowledge/taxonomy/algokit-utils - AlgoKit Utils documentation
• algorand://knowledge/taxonomy/tealscript - TEALScript documentation
• algorand://knowledge/taxonomy/puya - Puya documentation
• algorand://knowledge/taxonomy/liquid-auth - Liquid Auth documentation
• algorand://knowledge/taxonomy/python - Python development resources
• algorand://knowledge/taxonomy/developers - Developer documentation
• algorand://knowledge/taxonomy/clis - CLI tools documentation
• algorand://knowledge/taxonomy/nodes - Node management documentation
• algorand://knowledge/taxonomy/details - Technical details documentation

Each resource provides direct access to its respective documentation category in markdown format.

API Tools

API tools are designed to be used by Agent LLMs to perform various operations on the Algorand blockchain and to be easily invokable by LLM Agents. They are categorized into different sections based on their functionality.

Algod API Tools

• api_algod_get_account_info: Get current account balance, assets, and auth address from algod
• api_algod_get_account_application_info: Get account-specific application information from algod
• api_algod_get_account_asset_info: Get account-specific asset information from algod
• api_algod_get_application_by_id: Get application information
• api_algod_get_application_box: Get application box by name
• api_algod_get_application_boxes: Get all application boxes
• api_algod_get_asset_by_id: Get current asset information from algod
• api_algod_get_pending_transaction: Get pending transaction information
• api_algod_get_pending_transactions_by_address: Get pending transactions for an address
• api_algod_get_pending_transactions: Get all pending transactions
• api_algod_get_transaction_params: Get suggested transaction parameters
• api_algod_get_node_status: Get current node status
• api_algod_get_node_status_after_block: Get node status after a specific round

Indexer API Tools

• api_indexer_lookup_account_by_id: Get account information from indexer
• api_indexer_lookup_account_transactions: Get account transaction history
• api_indexer_lookup_account_assets: Get account assets
• api_indexer_lookup_account_app_local_states: Get account application local states
• api_indexer_lookup_account_created_applications: Get applications created by this account
• api_indexer_lookup_applications: Get application information from indexer
• api_indexer_lookup_application_logs: Get application log messages
• api_indexer_lookup_application_box: Get application box by name
• api_indexer_lookup_application_boxes: Get all application boxes
• api_indexer_lookup_asset_by_id: Get asset information and configuration
• api_indexer_lookup_asset_balances: Get accounts holding this asset and their balances
• api_indexer_lookup_asset_transactions: Get transactions involving this asset
• api_indexer_lookup_transaction_by_id: Get transaction information by ID
• api_indexer_search_accounts: Search for accounts with various criteria
• api_indexer_search_for_applications: Search for applications with various criteria
• api_indexer_search_for_assets: Search for assets with various criteria
• api_indexer_search_for_transactions: Search for transactions with various criteria

NFDomains (NFD) API Tools

• api_nfd_get_nfd: Get a specific NFD by name or application ID
• api_nfd_get_nfds_for_addresses: Get NFDs for specific addresses
• api_nfd_get_nfd_activity: Get activity/changes for NFDs
• api_nfd_get_nfd_analytics: Get analytics data for NFDs
• api_nfd_browse_nfds: Browse NFDs with various filters
• api_nfd_search_nfds: Search NFDs with various filters

Vestige API Tools

1. View Tools:

• api_vestige_view_networks: Get all networks
• api_vestige_view_network_by_id: Get network by id
• api_vestige_view_protocols: Get all protocols
• api_vestige_view_protocol_by_id: Get protocol by id
• api_vestige_view_protocol_volumes: Get protocol volumes at specific day
• api_vestige_view_assets: Get data about assets
• api_vestige_view_assets_list: Get asset list
• api_vestige_view_assets_search: Search assets by query
• api_vestige_view_asset_price: Get asset prices
• api_vestige_view_asset_candles: Get asset candles
• api_vestige_view_asset_history: Get asset volume, swaps, total lockup, vwap and confidence history
• api_vestige_view_asset_composition: Get asset lockups based on protocol and pair
• api_vestige_view_pools: Get pools
• api_vestige_view_vaults: Get all vaults
• api_vestige_view_balances: Get balances by network id, protocol id and asset id
• api_vestige_view_notes: Get notes by network id and optionally asset id
• api_vestige_view_first_asset_notes: Get first note for assets
• api_vestige_view_asset_notes_count: Get notes count for assets
• api_vestige_view_swaps: Get swaps

1. Swap Tools:

• api_vestige_get_best_v4_swap_data: Get best V4 swap data
• api_vestige_get_v4_swap_discount: Get V4 swap discount
• api_vestige_get_v4_swap_data_transactions: Get V4 swap data transactions
• api_vestige_get_aggregator_stats: Get aggregator stats

1. Currency Tools:

• api_vestige_view_currency_prices: Get all latest currency prices
• api_vestige_view_currency_price_history: Get currency prices by timestamp range
• api_vestige_view_currency_price: Get currency price by timestamp
• api_vestige_view_currency_average_price: Get average price for currency
• api_vestige_view_currency_prices_simple_30d: Get currency prices for last 30 days

Tinyman API Tools

• api_tinyman_get_pool: Get Tinyman pool information by asset pair

  • Parameters: asset1Id, asset2Id, version (v1_1 or v2)
  • Returns: Pool status, validator app ID, assets, and reserves

• api_tinyman_get_pool_analytics: Get analytics for a Tinyman pool

  • Parameters: asset1Id, asset2Id, version
  • Returns: Pool status, emptiness check, pair ratio, and reserves

• api_tinyman_get_pool_creation_quote: Get quote for creating a new pool

  • Parameters: asset1Id, asset2Id, initiatorAddr, version
  • Returns: Transaction count and estimated fees

• api_tinyman_get_liquidity_quote: Get quote for adding liquidity

  • Parameters: asset1Id, asset2Id, asset1Amount, asset2Amount, mode (initial/flexible/singleAsset), version
  • Returns: Liquidity quote with expected pool tokens

• api_tinyman_get_remove_liquidity_quote: Get quote for removing liquidity

  • Parameters: asset1Id, asset2Id, poolTokenAmount, initiatorAddr, slippage, singleAssetMode, version
  • Returns: Remove liquidity quote with expected asset amounts

• api_tinyman_get_swap_quote: Get quote for swapping assets

  • Parameters: assetIn, assetOut, amount, mode (fixedInput/fixedOutput), version
  • Returns: Swap quote with expected output/input amount

• api_tinyman_get_asset_optin_quote: Get quote for opting into pool token

  • Parameters: assetId, initiatorAddr
  • Returns: Transaction count and estimated fees

• api_tinyman_get_validator_optin_quote: Get quote for opting into validator

  • Parameters: initiatorAddr, version
  • Returns: Transaction count and estimated fees

• api_tinyman_get_validator_optout_quote: Get quote for opting out of validator

  • Parameters: initiatorAddr, version
  • Returns: Transaction count and estimated fees

Ultrade API Tools

1. Wallet Tools:

• api_ultrade_wallet_signin_message: Generate message from the sign in data

  • Parameters: data (address, technology), customMessage (optional)
  • Returns: Message to be signed

• api_ultrade_wallet_signin: Sign in to trading account

  • Parameters: message, signature, data (address, technology), referralToken (optional)
  • Returns: Session token

• api_ultrade_wallet_add_key: Add a trading key

  • Parameters: message, signature, walletAddress, walletToken
  • Returns: Trading key details

• api_ultrade_wallet_revoke_key: Revoke a trading key

  • Parameters: message, signature, walletAddress, walletToken
  • Returns: Operation status

• api_ultrade_wallet_keys: Get trading keys

  • Parameters: walletAddress, walletToken
  • Returns: List of trading keys

• api_ultrade_wallet_key_message: Generate message from the trading key data

  • Parameters: tkAddress, loginAddress, loginChainId, expiredDate (optional), addKey, type
  • Returns: Message to be signed

• api_ultrade_wallet_trades: Get filtered wallet trades

  • Parameters: walletAddress, walletToken (optional), tradingKey (optional)
  • Returns: List of trades

• api_ultrade_wallet_transactions: Get filtered wallet transactions

  • Parameters: walletAddress, walletToken (optional), tradingKey (optional)
  • Returns: List of transactions

• api_ultrade_wallet_withdraw: Withdraw token

  • Parameters: message, signature, walletAddress, walletToken
  • Returns: Withdrawal status

• api_ultrade_wallet_withdraw_message: Generate message from the withdrawal data

  • Parameters: data (withdrawal details), customMessage (optional)
  • Returns: Message to be signed

1. Market Tools:

• api_ultrade_market_symbols: Get market symbols

  • Returns: List of available trading pairs

• api_ultrade_market_details: Get market details

  • Parameters: symbol
  • Returns: Detailed market information

• api_ultrade_market_price: Get last market price by pair symbol

  • Parameters: symbol
  • Returns: Current market price

• api_ultrade_market_depth: Get order book depth

  • Parameters: symbol, depth
  • Returns: Order book with bids and asks

• api_ultrade_market_last_trades: Get last trades

  • Parameters: symbol, limit (optional)
  • Returns: Recent trade history

• api_ultrade_market_history: Get market history

  • Parameters: symbol, interval, startTime, endTime, limit (optional)
  • Returns: Historical market data

• api_ultrade_market_assets: Get trading assets

  • Returns: List of supported assets

• api_ultrade_market_fee_rates: Get fee rates

  • Returns: Current trading fee rates

• api_ultrade_market_chains: Get blockchain chains

  • Returns: Supported blockchain networks

• api_ultrade_market_withdrawal_fee: Get withdrawal fee

  • Parameters: tokenIndex, tokenChainId, recipientChainId
  • Returns: Withdrawal fee information

• api_ultrade_market_operation_details: Get operation details

  • Parameters: operationId
  • Returns: Operation status and details

• api_ultrade_market_settings: Get market settings

  • Parameters: domain
  • Returns: Market configuration

• api_ultrade_market_orders: Get orders

  • Parameters: walletAddress, walletToken, tradingKey (optional), companyId (optional)
  • Returns: List of orders

• api_ultrade_market_open_orders: Get open orders

  • Parameters: walletAddress, walletToken, tradingKey (optional), symbol (optional)
  • Returns: List of active orders

• api_ultrade_market_order_by_id: Get order by ID

  • Parameters: orderId, walletAddress, walletToken, tradingKey (optional)
  • Returns: Order details

• api_ultrade_market_order_message: Generate message from the order data

  • Parameters: data (order details)
  • Returns: Message to be signed

• api_ultrade_market_create_order: Create new order

  • Parameters: message, signature, walletAddress, walletToken
  • Returns: Order creation status

• api_ultrade_market_create_orders: Create new orders

  • Parameters: orders (array of message/signature pairs), walletAddress, walletToken
  • Returns: Batch order creation status

• api_ultrade_market_cancel_order: Cancel open order

  • Parameters: orderId, walletAddress, walletToken
  • Returns: Order cancellation status

• api_ultrade_market_cancel_orders: Cancel multiple open orders

  • Parameters: orderIds, walletAddress, walletToken
  • Returns: Batch cancellation status

1. System Tools:

• api_ultrade_system_time: Get current system time

  • Returns: Server timestamp

• api_ultrade_system_maintenance: Get system maintenance status

  • Returns: Maintenance mode information

• api_ultrade_system_version: Get system version

  • Returns: Current API version

Account Management Tools

1. create_account

   • Creates a new Algorand account
   • Returns address and mnemonic
   • No parameters required

2. rekey_account

   • Rekeys an account to a new address
   • Parameters:

     {
       sourceAddress: string,  // Account to rekey
       targetAddress: string   // New authorized address
     }

3. mnemonic_to_mdk

   • Converts mnemonic to master derivation key
   • Parameters: { mnemonic: string }

4. mdk_to_mnemonic

   • Converts master derivation key to mnemonic
   • Parameters: { mdk: string }

5. secret_key_to_mnemonic

   • Converts secret key to mnemonic
   • Parameters: { secretKey: string }

6. mnemonic_to_secret_key

   • Converts mnemonic to secret key
   • Parameters: { mnemonic: string }

7. seed_from_mnemonic

   • Generates seed from mnemonic
   • Parameters: { mnemonic: string }

8. mnemonic_from_seed

   • Generates mnemonic from seed
   • Parameters: { seed: string }

9. validate_address

   • Validates Algorand address format
   • Parameters: { address: string }

10. encode_address

    • Encodes public key to address
    • Parameters: { publicKey: string }

11. decode_address

    • Decodes address to public key
    • Parameters: { address: string }

Application Tools

1. make_app_create_txn

   • Creates application creation transaction
   • Parameters:

     {
       from: string,
       approvalProgram: string,
       clearProgram: string,
       numGlobalByteSlices: number,
       numGlobalInts: number,
       numLocalByteSlices: number,
       numLocalInts: number,
       extraPages?: number,
       note?: string,
       lease?: string,
       rekeyTo?: string,
       appArgs?: string[],
       accounts?: string[],
       foreignApps?: number[],
       foreignAssets?: number[]
     }

2. make_app_update_txn

   • Creates application update transaction
   • Parameters: Similar to create with appIndex

3. make_app_delete_txn

   • Creates application deletion transaction
   • Parameters: { from: string, appIndex: number }

4. make_app_optin_txn

   • Creates application opt-in transaction
   • Parameters: { from: string, appIndex: number }

5. make_app_closeout_txn

   • Creates application close-out transaction
   • Parameters: { from: string, appIndex: number }

6. make_app_clear_txn

   • Creates application clear state transaction
   • Parameters: { from: string, appIndex: number }

7. make_app_call_txn

   • Creates application call transaction
   • Parameters:

     {
       from: string,
       appIndex: number,
       appArgs?: string[],
       accounts?: string[],
       foreignApps?: number[],
       foreignAssets?: number[]
     }

8. get_application_address

   • Gets application's escrow address
   • Parameters: { appId: number }

Asset Tools

1. make_asset_create_txn

   • Creates asset creation transaction
   • Parameters:

     {
       from: string,
       total: number,
       decimals: number,
       defaultFrozen: boolean,
       unitName?: string,
       assetName?: string,
       assetURL?: string,
       assetMetadataHash?: string,
       manager?: string,
       reserve?: string,
       freeze?: string,
       clawback?: string
     }

2. make_asset_config_txn

   • Creates asset configuration transaction
   • Parameters:

     {
       from: string,
       assetIndex: number,
       manager?: string,
       reserve?: string,
       freeze?: string,
       clawback?: string,
       strictEmptyAddressChecking: boolean
     }

3. make_asset_destroy_txn

   • Creates asset destruction transaction
   • Parameters: { from: string, assetIndex: number }

4. make_asset_freeze_txn

   • Creates asset freeze transaction
   • Parameters:

     {
       from: string,
       assetIndex: number,
       freezeTarget: string,
       freezeState: boolean
     }

5. make_asset_transfer_txn

   • Creates asset transfer transaction
   • Parameters:

     {
       from: string,
       to: string,
       assetIndex: number,
       amount: number,
       closeRemainderTo?: string
     }

Transaction Tools

1. make_payment_txn

   • Creates payment transaction
   • Parameters:

     {
       from: string,
       to: string,
       amount: number,
       closeRemainderTo?: string
     }

2. assign_group_id

   • Assigns group ID to transactions
   • Parameters: { transactions: Transaction[] }

3. sign_transaction

   • Signs transaction with secret key
   • Parameters:

     {
       transaction: Transaction,
       sk: string
     }

4. sign_bytes

   • Signs arbitrary bytes
   • Parameters: { bytes: string, sk: string }

5. send_raw_transaction

   • Broadcasts signed transactions
   • Parameters: { signedTxns: string[] }

6. simulate_raw_transactions

   • Simulates raw transactions
   • Parameters: { txns: string[] }

Key Management Tools

1. generate_key_pair

   • Generates new public/private key pair
   • Parameters: None
   • Returns: { publicKey: string, privateKey: string }

2. derive_key

   • Derives a key from a master key
   • Parameters: { masterKey: string, index: number }

Utility Tools

1. encode_obj

   • Encodes object to msgpack
   • Parameters: { obj: any }

2. decode_obj

   • Decodes msgpack to object
   • Parameters: { bytes: string }

3. bytes_to_bigint

   • Converts bytes to BigInt
   • Parameters: { bytes: string }

4. bigint_to_bytes

   • Converts BigInt to bytes
   • Parameters: { value: string, size: number }

5. encode_uint64

   • Encodes uint64 to bytes
   • Parameters: { value: string }

6. decode_uint64

   • Decodes bytes to uint64
   • Parameters: { bytes: string }

7. compile_teal

   • Compiles TEAL source code
   • Parameters: { source: string }

8. disassemble_teal

   • Disassembles TEAL bytecode
   • Parameters: { bytecode: string }

Available Resources

Algod Resources (Real-time State)

1. algorand://algod/accounts/{address}

   • Gets current account information
   • Returns: Balance, assets, auth address

2. algorand://algod/accounts/{address}/application/{app-id}

   • Gets account's application state
   • Returns: Local state for specific app

3. algorand://algod/accounts/{address}/asset/{asset-id}

   • Gets account's asset holding
   • Returns: Asset balance and frozen state

4. algorand://algod/applications/{app-id}

   • Gets application information
   • Returns: Global state, creator, approval/clear programs

5. algorand://algod/applications/{app-id}/box/{name}

   • Gets application box contents
   • Returns: Box value

6. algorand://algod/applications/{app-id}/boxes

   • Lists all application boxes
   • Returns: Box names and sizes

7. algorand://algod/assets/{asset-id}

   • Gets asset information
   • Returns: Asset parameters and current state

8. algorand://algod/transactions/pending/{txid}

   • Gets pending transaction
   • Returns: Transaction details

9. algorand://algod/accounts/{address}/transactions/pending

   • Lists pending transactions for account
   • Returns: Array of transactions

10. algorand://algod/transactions/pending

    • Lists all pending transactions
    • Returns: Array of transactions

11. algorand://algod/transactions/params

    • Gets suggested parameters
    • Returns: Current network parameters

12. algorand://algod/status

    • Gets node status
    • Returns: Current round, versions

Block Resources

1. algorand://algod/blocks/latest

   • Gets latest block information
   • Returns: Latest block header and transactions

2. algorand://algod/blocks/{round}

   • Gets specific block information
   • Returns: Block header and transactions

3. algorand://algod/blocks/{round}/transactions

   • Gets transactions in specific block
   • Returns: Array of transactions

4. algorand://indexer/blocks/{round}

   • Gets historical block information
   • Returns: Block details with transactions

Health Resources

1. algorand://algod/health

   • Gets node health status
   • Returns: Node health information

2. algorand://indexer/health

   • Gets indexer health status
   • Returns: Indexer health information

Genesis Resources

1. algorand://algod/genesis

   • Gets genesis information
   • Returns: Network genesis configuration

2. algorand://indexer/genesis

   • Gets historical genesis information
   • Returns: Network genesis details

Network Resources

1. algorand://algod/versions

   • Gets supported protocol versions
   • Returns: Supported versions information

2. algorand://algod/metrics

   • Gets node metrics
   • Returns: Performance metrics

Supply Resources

1. algorand://algod/ledger/supply

   • Gets current supply information
   • Returns: Total and online stake

2. algorand://indexer/supply

   • Gets historical supply information
   • Returns: Historical supply data

Participation Resources

1. algorand://algod/participation

   • Gets participation key information
   • Returns: Key registration info

2. algorand://algod/participation/keys

   • Lists participation keys
   • Returns: Array of keys

3. algorand://algod/participation/keys/{id}

   • Gets specific participation key
   • Returns: Key details

Fee Resources

1. algorand://algod/transactions/fee

   • Gets suggested fee
   • Returns: Current fee information

2. algorand://indexer/fee-distribution

   • Gets historical fee distribution
   • Returns: Fee statistics

Protocol Resources

1. algorand://algod/protocol

   • Gets current protocol parameters
   • Returns: Protocol configuration

2. algorand://indexer/protocol-upgrades

   • Gets protocol upgrade history
   • Returns: Upgrade information

Node Resources

1. algorand://algod/ready

   • Checks if node is ready
   • Returns: Readiness status

2. algorand://algod/sync

   • Gets node sync status
   • Returns: Sync information

3. algorand://algod/peers

   • Lists connected peers
   • Returns: Peer information

4. algorand://algod/catchup

   • Gets catchup information
   • Returns: Catchup status

Compile Resources

1. algorand://algod/compile/teal

   • Compiles TEAL program
   • Returns: Compilation result

2. algorand://algod/compile/teal/disassemble

   • Disassembles TEAL bytecode
   • Returns: Source code

3. algorand://algod/compile/teal/dryrun

   • Dry runs TEAL program
   • Returns: Execution result

Debug Resources

1. algorand://algod/debug/accounts/{address}

   • Gets detailed account debug info
   • Returns: Internal state

2. algorand://algod/debug/txns/{txid}

   • Gets transaction debug info
   • Returns: Execution details

3. algorand://algod/debug/blocks/{round}

   • Gets block debug info
   • Returns: Internal state

4. algorand://algod/debug/ledger

   • Gets ledger debug info
   • Returns: Database state

Indexer Resources (Historical Data)

1. algorand://indexer/accounts/{address}

   • Gets account history
   • Returns: Historical account state

2. algorand://indexer/accounts/{address}/transactions

   • Gets account transactions
   • Returns: Transaction history

3. algorand://indexer/accounts/{address}/apps-local-state

   • Gets account's application states
   • Returns: All local states

4. algorand://indexer/accounts/{address}/created-applications

   • Gets created applications
   • Returns: Applications created by account

5. algorand://indexer/applications/{app-id}

   • Gets application history
   • Returns: Historical application state

6. algorand://indexer/applications/{app-id}/logs

   • Gets application logs
   • Returns: Historical log messages

7. algorand://indexer/applications/{app-id}/box/{name}

   • Gets historical box state
   • Returns: Box value at specific round

8. algorand://indexer/applications/{app-id}/boxes

   • Lists historical boxes
   • Returns: Box names at specific round

9. algorand://indexer/applications

   • Searches applications
   • Returns: Matching applications

10. algorand://indexer/assets/{asset-id}

    • Gets asset history
    • Returns: Historical asset state

11. algorand://indexer/assets/{asset-id}/balances

    • Gets asset holders
    • Returns: Accounts holding asset

12. algorand://indexer/assets/{asset-id}/transactions

    • Gets asset transactions
    • Returns: Transactions involving asset

13. algorand://indexer/assets/{asset-id}/balances/{address}

    • Gets historical asset balance
    • Returns: Account's asset balance

14. algorand://indexer/assets/{asset-id}/transactions/{txid}

    • Gets specific asset transaction
    • Returns: Transaction details

15. algorand://indexer/assets

    • Searches assets
    • Returns: Matching assets

16. algorand://indexer/transactions/{txid}

    • Gets transaction details
    • Returns: Historical transaction

17. algorand://indexer/transactions

    • Searches transactions
    • Returns: Matching transactions

Response Format

All responses follow a standardized format using ResponseProcessor:

{
  "data": {
    // Response data here
  },
  "metadata": {  // Only for paginated responses
    "totalItems": number,
    "itemsPerPage": number,
    "currentPage": number,
    "totalPages": number,
    "hasNextPage": boolean,
    "pageToken": string,
    "arrayField": string  // Name of paginated array field
  }
}

Error Handling

The server provides detailed error messages for common issues:

• Invalid parameters
• Network connection errors
• Transaction failures
• Resource not found errors
• Authorization errors

Errors are returned in a standardized format:

{
  "error": {
    "code": string,
    "message": string
  }
}

License

MIT