Skip to main content
Glama
VeChain AI Terminal MCP Server

VeChain AI Terminal MCP Server

VeChain AI Terminal ~ MCP Server

VeChain AI Terminal Banner

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with the VeChain blockchain through natural language commands. The server provides comprehensive blockchain operations including token transfers, DEX trading, cross-chain bridges, NFT management, and VeBetter DAO interactions.

Overview

VeChain AI Terminal bridges the gap between AI assistants and blockchain functionality by providing a natural language interface to VeChain's ecosystem. Users can perform complex blockchain operations through simple conversational commands with Claude Desktop.

Related MCP server: MCP Crypto Wallet EVM

Architecture

VeChain AI Architecture Banner

graph TB
    subgraph "Claude Desktop"
        A[User Interface]
        B[Claude AI]
    end
    
    subgraph "MCP Server"
        C[Tool Registry]
        D[Plugin System]
        E[Core Framework]
    end
    
    subgraph "VeChain Plugins"
        F[Token Operations]
        G[DEX Trading]
        H[Cross-Chain Bridges]
        I[NFT Management]
        J[VeBetter DAO]
        K[StarGate Staking]
        L[Analytics]
    end
    
    subgraph "VeChain Network"
        M[VeChain Mainnet]
        N[VeChain Testnet]
        O[Smart Contracts]
    end
    
    subgraph "External APIs"
        P[VeChainStats API]
        Q[WanBridge API]
        R[XFlows API]
        S[B32 Repository]
    end
    
    A --> B
    B <--> C
    C --> D
    D --> E
    E --> F
    E --> G
    E --> H
    E --> I
    E --> J
    E --> K
    E --> L
    
    F --> M
    F --> N
    G --> O
    H --> Q
    H --> R
    I --> O
    J --> O
    K --> O
    L --> P
    L --> S

VeChain AI Tools Banner

System Components

Core Framework

  • Tool Decorator System: Marks functions as AI-accessible tools with parameter validation

  • Plugin Base: Abstract foundation for all blockchain operation plugins

  • Wallet Client: Manages VeChain wallet connections and transaction signing

  • Registry Services: Maintains contract addresses, token definitions, and ABI mappings

Plugin Architecture

VeChain AI Architecture Banner

graph LR
    subgraph "Plugin Structure"
        A[Plugin Class] --> B[Service Layer]
        B --> C[Tool Methods]
        C --> D[Parameter Validation]
        D --> E[Blockchain Execution]
    end
    
    subgraph "Available Plugins"
        F[Token Plugin<br/>VET/VTHO/B3TR transfers]
        G[DEX Plugin<br/>VeSwap, BetterSwap trading]
        H[Bridge Plugin<br/>WanBridge, XFlows]
        I[NFT Plugin<br/>VIP-181 operations]
        J[VeBetter Plugin<br/>Sustainable rewards]
        K[StarGate Plugin<br/>NFT staking & delegation]
        L[Stats Plugin<br/>Blockchain analytics]
    end

Features

Blockchain Operations

  • Token Transfers: Native VET and VIP-180 token operations

  • Balance Queries: Real-time account balance monitoring

  • Transaction History: Comprehensive transaction tracking

  • Gas Estimation: Automatic fee calculation and optimization

DEX Integration

  • Multi-DEX Support: VeSwap, BetterSwap, Vexchange integration

  • Price Discovery: Real-time token price feeds and comparison

  • Liquidity Analysis: Pool information and trading volume metrics

  • Swap Execution: Automated token exchange with slippage protection

Cross-Chain Operations

  • WanBridge Integration: Secure asset transfers between networks

  • XFlows Support: Advanced cross-chain swap protocols

  • Bridge Monitoring: Real-time transfer status tracking

  • Multi-Network Support: Ethereum, Polygon, BSC connectivity

NFT Management

  • VIP-181 Operations: Complete NFT lifecycle management

  • Metadata Handling: IPFS integration for rich media content

  • Collection Analytics: Comprehensive NFT project statistics

  • Transfer Operations: Secure ownership transfers

VeBetter DAO

  • Sustainable Actions: Submit and validate eco-friendly activities

  • B3TR Rewards: Automated token distribution for verified actions

  • Governance Participation: Proposal voting and delegation

  • Impact Tracking: Environmental contribution monitoring

StarGate Staking

  • NFT-Based Staking: Stake VET to mint tier-specific StarGate NFTs

  • Multi-Tier System: Support for all 10 StarGate tiers (Dawn to Mjolnir X)

  • Delegation Rewards: Start/stop delegation for enhanced VTHO rewards

  • Legacy Migration: Seamless migration from old VeChain nodes

  • Real-time Analytics: Track staking performance and reward accumulation

  • Complete Operations: 13 fully functional MCP tools for all StarGate operations

Quick Start

Prerequisites

  • Claude Desktop application

  • Node.js 18 or higher

  • pnpm package manager

  • VeChain wallet (private key or mnemonic)

Installation

  1. Clone and build the server

    git clone https://github.com/VeChain-AI-Terminal/vechain-mcp-server
    cd vechain-mcp-server
    pnpm install
    pnpm build
  2. Configure environment variables

    cp .env.example .env

    Edit .env file with your wallet credentials and network preferences.

  3. Automated Setup (Recommended)

    Use the automated setup script to configure your preferred AI application:

    # Interactive mode - choose which application to configure
    pnpm setup
    
    # Configure Claude Desktop only
    pnpm setup:claude
    
    # Configure Cursor editor only
    pnpm setup:cursor
    
    # Configure VS Code only
    pnpm setup:code
    
    # Configure multiple applications
    ./setup-mcp.sh --claude --cursor --code

    The setup script will:

    • Read your .env configuration

    • Generate the appropriate MCP configuration

    • Install it in the correct location for your chosen application(s)

    • Provide restart instructions

  4. Manual Configuration (Alternative)

    If you prefer manual setup, you can configure the applications directly:

    Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json Cursor Editor: ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-specific)
    VS Code: ~/Library/Application Support/Code/User/mcp.json (global) or .vscode/mcp.json (project-specific)

    The configuration format should look like:

    {
      "mcpServers": {
        "vechain-mcp": {
          "command": "node",
          "args": ["/absolute/path/to/vechain-mcp-server/dist/index.js"],
          "env": {
            "WALLET_MNEMONIC": "your twelve word mnemonic phrase here",
            "VECHAIN_NETWORK": "testnet",
            "VECHAINSTATS_API_KEY": "your_vechainstats_api_key",
            "VEBETTER_REWARDS_POOL_ADDRESS": "0x5F8f86B8D0Fa93cdaE20936d150175dF0205fB38",
            "VEBETTER_B3TR_TOKEN_ADDRESS": "0xbf64cf86894Ee0877C4e7d03936e35Ee8D8b864F",
            "VEBETTER_APPS_REGISTRY_ADDRESS": "0xcB23Eb1bBD5c07553795b9538b1061D0f4ABA153",
            "VEBETTER_APP_ID": "your_app_id_here",
            "BRIDGE_API_URL": "https://bridge-api.wanchain.org/api",
            "BRIDGE_PARTNER": "vechain-ai-superapp"
          }
        }
      }
    }
  5. Restart your AI application

Close and reopen Claude Desktop, Cursor, or VS Code to load the MCP server.

Environment Configuration

Variable

Required

Description

WALLET_PRIVATE_KEY

Either

VeChain wallet private key

WALLET_MNEMONIC

Either

VeChain wallet mnemonic phrase

VECHAIN_NETWORK

Yes

Network selection: mainnet or testnet

VECHAINSTATS_API_KEY

No

Enhanced blockchain data access

VEBETTER_ACTION_CONTRACT

No

VeBetter action submission contract

VEBETTER_REWARD_CONTRACT

No

VeBetter reward distribution contract

Network Endpoints

  • Testnet: https://testnet.veblocks.net (development use)

  • Mainnet: https://mainnet.veblocks.net (production use)

Usage Examples

Token Operations

"Transfer 100 VET to 0x742d35Cc6651Fb66D8dD9b2a5D35bfa2F9d2E7c7"
"Check my VTHO balance"
"Send 50 B3TR tokens to alice.vet"

DEX Trading

"Swap 100 VET for VTHO on VeSwap"
"Get the best price for 1000 B3TR to VET"
"What's the current VET/VTHO exchange rate?"

Cross-Chain Operations

"Bridge 500 VET from VeChain to Ethereum using WanBridge"
"Check my bridge transaction status for hash 0x..."
"What are the current bridge fees for VET to Polygon?"

NFT Operations

"Mint an NFT with metadata from ipfs://QmHash"
"Transfer my NFT #123 from collection 0x... to 0x..."
"Show me all NFTs in my wallet"

VeBetter Rewards

"Submit a sustainable action: I used public transport for 20km today"
"Check my available B3TR rewards"
"Claim my pending VeBetter rewards"

StarGate Staking Operations

"Stake 10,000 VET for a Dawn tier StarGate NFT"
"Show me all my StarGate NFTs and their details"
"Start delegating my StarGate NFT #123 for rewards"
"Claim my VTHO rewards from token 456"
"What are the current StarGate staking tiers and requirements?"
"Stop delegation for my Mjolnir X node"
"Get delegation status for my StarGate NFT #789"
"Check if my StarGate NFT can be transferred"
"Get maturity information for my StarGate NFT"
"Unstake my StarGate NFT to get my VET back"

StarGate Operations Reference

The VeChain AI Terminal provides comprehensive StarGate staking functionality with 13 fully tested MCP tools:

🏦 Staking Functions

stake_vet

Stake VET to mint a StarGate NFT of specified level

  • Parameters:

    • levelId (number, 1-10): StarGate tier level ID

    • autoDelegate (boolean, optional): Auto-delegate for additional rewards

  • Example: "Stake 5 VET for Lightning level with auto-delegation"

unstake_stargate_nft

Unstake a StarGate NFT to burn it and retrieve the staked VET

  • Parameters:

    • tokenId (string): StarGate NFT token ID to unstake

  • Example: "Unstake my StarGate NFT #100165"

📊 Query Functions

get_staking_levels

Get all available StarGate staking levels with requirements and rewards

  • Parameters:

    • category (optional): Filter by 'all', 'eco', 'x', or 'new-eco'

  • Returns: All 10 levels (Dawn, Lightning, Flash, VeThorX, Strength, StrengthX, Thunder, ThunderX, Mjolnir, MjolnirX)

get_user_stakes

Get all StarGate NFTs owned by an address with detailed information

  • Parameters:

    • address (string): User address to check stakes for

  • Returns: Complete portfolio with NFT details

get_stake_info

Get detailed information about a specific StarGate NFT by token ID

  • Parameters:

    • tokenId (string): StarGate NFT token ID to get info for

  • Returns: Complete token details, maturity status, claimable VTHO

🔍 Utility Functions

get_ids_owned_by

Get all StarGate NFT token IDs owned by an address

  • Parameters:

    • address (string): Address to get owned token IDs for

get_level_supply

Get circulating supply and cap for a specific StarGate level

  • Parameters:

    • levelId (number): Level ID to get supply info for

token_exists

Check if a StarGate NFT token exists

  • Parameters:

    • tokenId (string): Token ID to check existence

can_transfer_stargate_nft

Check if a StarGate NFT can be transferred (maturity period has ended)

  • Parameters:

    • tokenId (string): Token ID to check transfer eligibility

get_maturity_end_block

Get the block number when the maturity period ends for a StarGate NFT

  • Parameters:

    • tokenId (string): Token ID to get maturity end block for

is_under_maturity_period

Check if a StarGate NFT is still under maturity period

  • Parameters:

    • tokenId (string): Token ID to check maturity status

get_token_level

Get the level ID of a StarGate NFT

  • Parameters:

    • tokenId (string): Token ID to get level for

💰 VTHO Reward Functions

claim_vtho_rewards

Claim accumulated VTHO rewards for a StarGate NFT

  • Parameters:

    • tokenId (string): StarGate NFT token ID to claim rewards for

🎯 StarGate Tier System

Level

Name

VET Required

Maturity

Reward Factor

Type

1

Strength

100 VET

30 days

1.5x

Standard

2

Thunder

1,000 VET

60 days

2.0x

Standard

3

Mjolnir

10,000 VET

90 days

2.5x

Standard

4

VeThorX

100,000 VET

No maturity

3.0x

X-Series

5

StrengthX

500,000 VET

No maturity

3.5x

X-Series

6

ThunderX

1,000,000 VET

No maturity

4.0x

X-Series

7

MjolnirX

5,000,000 VET

No maturity

4.5x

X-Series

8

Dawn

1 VET

7 days

1.2x

Standard

9

Lightning

5 VET

14 days

1.3x

Standard

10

Flash

50 VET

21 days

1.4x

Standard

✅ Testing Status

All 13 StarGate MCP functions have been successfully tested with real transactions on VeChain testnet, including:

  • ✅ Staking operations (stake_vet, unstake_stargate_nft)

  • ✅ Portfolio queries (get_user_stakes, get_stake_info)

  • ✅ Utility functions (token_exists, can_transfer_stargate_nft)

  • ✅ Maturity checks (is_under_maturity_period, get_maturity_end_block)

  • ✅ VTHO rewards (claim_vtho_rewards)

  • ✅ Level management (get_staking_levels, get_level_supply)

Analytics and Data

"Show me the latest VeChain network statistics"
"What's the current VET price and market cap?"
"Get transaction history for the last 7 days"

Development

Plugin Development

Create new plugins by extending the base plugin class:

import { PluginBase } from '../core/PluginBase';
import { Tool } from '../core/Tool.decorator';

export class CustomPlugin extends PluginBase {
  @Tool({
    description: "Custom blockchain operation",
    parameters: {
      address: { type: "string", description: "Target address" }
    }
  })
  async customOperation(address: string) {
    // Implementation
  }
}

Adding New Tools

  1. Create plugin file in src/plugins/

  2. Implement service methods with @Tool decorators

  3. Register plugin in src/index.ts

  4. Build and test functionality

Testing

# Development mode
pnpm dev

# Type checking
pnpm typecheck

# Production build
pnpm build

# Test MCP connection
pnpm test-mcp

Security Considerations

Wallet Security

  • Store private keys securely using environment variables

  • Never commit credentials to version control

  • Use testnet for development and testing

  • Verify all transaction details before execution

API Security

  • Protect API keys with appropriate access controls

  • Use HTTPS for all external API communications

  • Implement rate limiting for high-frequency operations

  • Validate all input parameters and responses

Network Security

  • Use official RPC endpoints for blockchain connections

  • Verify smart contract addresses before interaction

  • Monitor transaction fees and gas usage

  • Implement proper error handling and logging

Integration APIs

VeChain SDK

Core blockchain operations using official VeChain TypeScript SDK with support for transaction creation, signing, and broadcasting.

VeChainStats API

Comprehensive blockchain analytics including network statistics, token information, and transaction history.

WanBridge API

Cross-chain bridge operations for secure asset transfers between VeChain and other blockchain networks.

XFlows API

Advanced cross-chain swap protocols enabling complex multi-hop transactions across different networks.

B32 Repository

Dynamic ABI loading system for smart contract interactions without requiring manual ABI management.

Troubleshooting

Common Issues

Tool not found errors

  • Restart Claude Desktop after configuration changes

  • Verify absolute paths in configuration file

  • Check environment variable settings

Invalid address formats

  • Ensure VeChain addresses start with 0x

  • Verify address checksums for accuracy

  • Use proper ENS name resolution where supported

Insufficient balance errors

  • Check VET balance for transaction fees

  • Verify token balances before transfers

  • Consider network congestion effects on gas prices

Network connectivity issues

  • Verify RPC endpoint accessibility

  • Check firewall and proxy settings

  • Test alternative network endpoints

Debug Mode

Enable detailed logging:

export DEBUG=true
pnpm dev

Contributing

This project demonstrates AI-blockchain integration patterns and welcomes contributions. Please follow these guidelines:

  1. Fork the repository and create feature branches

  2. Follow TypeScript coding standards and conventions

  3. Add comprehensive tests for new functionality

  4. Update documentation for API changes

  5. Submit pull requests with detailed descriptions

License

MIT License - see LICENSE file for complete terms and conditions.


VeChain AI Terminal - Bridging artificial intelligence with blockchain technology through natural language interactions.

Available Tools

92 tools
bridge_check_statusA

Check cross-chain bridge transaction status (section 4.1). Accepts hash from either source or destination chain.

Inputs: txHash (required).

bridge_create_transactionA

Create a cross-chain bridge transaction using WanBridge API (section 2.2). Returns transaction data ready for wallet signing.

Inputs: amount (required), toChain (required), toToken (required), fromChain (required), +4 more.

bridge_get_quota_and_feeB

Get bridge quota (min/max limits) and fees in one call (section 1.2.3)

Inputs: symbol (required), toChainType (required), fromChainType (required), tokenPairID.

bridge_get_smg_idA

Get current Storeman Group ID (smgID) for cross-chain operations (section 1.4)

Inputs: no named parameters.

bridge_get_token_pairsB

Get all available cross-chain token pairs (300+ pairs across 25+ chains)

Inputs: toChain, fromChain.

bridge_get_token_pairs_hashA

Get hash of token pairs data to check if it changed (for caching optimization)

Inputs: no named parameters.

can_transfer_stargate_nftA

Check if a StarGate NFT can be transferred (maturity period has ended)

Inputs: tokenId (required).

claim_vtho_rewardsC

Claim accumulated VTHO rewards for a StarGate NFT

Inputs: tokenId (required).

dex_calculate_slippageA

Calculate minimum output amount based on slippage tolerance

Inputs: expectedAmount (required), slippagePercent (required).

dex_execute_swapB

Execute a token swap on a VeChain DEX

Inputs: dexName (required), toToken (required), amountIn (required), fromToken (required), +2 more.

dex_get_available_dexesA

Get list of all available DEXes on VeChain with their status

Inputs: dexName.

dex_get_pair_reservesB

Get liquidity pool reserves for a token pair on a DEX

Inputs: tokenA (required), tokenB (required), dexName (required).

dex_get_swap_quoteA

Get a quote for token swap on a VeChain DEX (calculates expected output amount)

Inputs: dexName (required), toToken (required), amountIn (required), fromToken (required).

dex_get_trade_historyB

Get DEX trading history for an address (uses VeChainStats API)

Inputs: address.

get_balanceB

Get VET and VTHO balance for an address

Inputs: address (required), tokenSymbol (required).

get_chain_infoC

Get information about the connected blockchain

Inputs: no named parameters.

get_ids_owned_byB

Get all StarGate NFT token IDs owned by an address

Inputs: address (required).

get_level_supplyA

Get circulating supply and cap for a specific StarGate level

Inputs: levelId (required).

get_maturity_end_blockA

Get the block number when the maturity period ends for a StarGate NFT

Inputs: tokenId (required).

get_stake_infoB

Get detailed information about a specific StarGate NFT by token ID

Inputs: tokenId (required).

get_staking_levelsA

Get all available StarGate staking levels with requirements and rewards

Inputs: category.

get_token_infoB

Get information about a token by its symbol (VET, VTHO, B3TR, etc)

Inputs: tokenSymbol (required).

get_token_levelB

Get the level ID of a StarGate NFT

Inputs: tokenId (required).

get_user_stakesA

Get all StarGate NFTs owned by an address with detailed information

Inputs: address (required).

get_wallet_addressA

Get the connected wallet address

Inputs: no named parameters.

is_under_maturity_periodB

Check if a StarGate NFT is still under maturity period

Inputs: tokenId (required).

nft_approveB

Approve another address to transfer a specific NFT

Inputs: tokenId (required), operator (required), contractAddress (required).

nft_burnA

Burn (destroy) an NFT token

Inputs: tokenId (required), contractAddress (required).

nft_check_ownershipB

Check who owns a specific NFT token

Inputs: tokenId (required), contractAddress (required).

nft_get_all_collectionsB

Get all NFT collections on VeChain (uses VeChainStats API)

Inputs: no named parameters.

nft_get_collection_infoC

Get detailed information about an NFT collection

Inputs: collectionId (required).

nft_get_floor_priceB

Get floor price and market data for an NFT collection (uses VeChainStats)

Inputs: collectionId (required).

nft_get_metadataA

Get metadata for a specific NFT token

Inputs: tokenId (required), contractAddress (required).

nft_get_owned_tokensA

Get all NFTs owned by a specific address

Inputs: address (required), collectionAddress.

nft_get_transfer_historyC

Get NFT transfer history for an address (uses VeChainStats)

Inputs: address (required), page.

nft_mintA

Mint a new NFT token (requires minter role on contract)

Inputs: contractAddress (required), to, tokenId, tokenURI.

nft_transferB

Transfer an NFT to another address

Inputs: to (required), tokenId (required), contractAddress (required), safe.

sign_messageB

Sign a message with the wallet

Inputs: message (required).

stake_vetB

Stake VET to mint a StarGate NFT (Dawn, Lightning, Flash, Strength, Thunder, Mjolnir levels)

Inputs: levelId (required), autoDelegate.

token_existsB

Check if a StarGate NFT token exists

Inputs: tokenId (required).

transfer_tokenA

Transfer VIP-180 tokens (like VTHO, B3TR) to another address

Inputs: to (required), amount (required), tokenSymbol (required), tokenAddress (required).

transfer_vetB

Transfer VET (native VeChain tokens) to another address

Inputs: to (required), amount (required), memo.

unstake_stargate_nftA

Unstake a StarGate NFT to burn it and retrieve the staked VET

Inputs: tokenId (required).

vebetter_check_available_fundsB

Check available B3TR funds in the rewards pool for an app

Inputs: appId (required).

vebetter_claim_rewardsB

Claim accumulated B3TR rewards from a VeBetter app

Inputs: appId (required), amount (required).

vebetter_example_submissionsB

Get example submissions for different sustainable actions

Inputs: no named parameters.

vebetter_get_app_infoD

Get information about a VeBetter app

Inputs: appId (required).

vebetter_get_impact_categoriesA

Get list of valid impact categories for VeBetter submissions

Inputs: no named parameters.

vebetter_submit_actionB

Submit a sustainable action to a VeBetter app for rewards

Inputs: appId (required), proofType (required), proofValue (required), description (required), +2 more.

vechainstats_get_account_daily_statsC

Get daily statistics for accounts (new accounts, active accounts, etc.)

Inputs: date (required), expanded.

vechainstats_get_account_infoB

Get comprehensive account information including balances, transaction count, and more

Inputs: address (required), expanded.

vechainstats_get_account_vtho_infoA

Get detailed VTHO information for an account (generation rate, accumulated, etc.)

Inputs: address (required), expanded.

vechainstats_get_address_emissionsA

Get carbon emissions (CO2e) for an address - perfect for VeBetter sustainability tracking!

Inputs: txid, address, blocknum, timeframe.

vechainstats_get_all_token_pricesA

Get prices for all VeChain tokens in one call

Inputs: no named parameters.

vechainstats_get_authority_nodesA

Get list of authority nodes (validators) on VeChain

Inputs: no named parameters.

vechainstats_get_block_by_referenceB

Get block by block reference (8-byte hex string)

Inputs: blockref (required).

vechainstats_get_block_by_timestampB

Find block by timestamp

Inputs: blockts (required).

vechainstats_get_block_daily_statsB

Get daily block statistics (gas used, transaction count, etc.)

Inputs: date, expanded.

vechainstats_get_block_infoC

Get detailed information about a specific block

Inputs: blocknum (required).

vechainstats_get_contract_codeC

Get verified contract source code

Inputs: address (required), expanded.

vechainstats_get_contract_infoB

Get contract information including verification status and metadata

Inputs: address (required), expanded.

vechainstats_get_current_blockA

Get the current block height of VeChain

Inputs: no named parameters.

vechainstats_get_dex_tradesB

Get DEX trading history for an address across all VeChain DEXes (VeSwap, Vexchange, etc.)

Inputs: address (required), page, sort.

vechainstats_get_gas_statsA

Get gas price statistics and trends

Inputs: no named parameters.

vechainstats_get_historic_balanceA

Get historical VET/VTHO balance at a specific date or block

Inputs: address (required), date, blocknum.

vechainstats_get_mempoolA

Get current mempool information (pending transactions)

Inputs: no named parameters.

vechainstats_get_network_emissionsA

Get total network carbon emissions - VeChain is carbon-neutral!

Inputs: no named parameters.

vechainstats_get_network_statsC

Get network statistics for a specific timeframe

Inputs: timeframe.

vechainstats_get_network_totalsB

Get network-wide totals (accounts, transactions, contracts, blocks)

Inputs: no named parameters.

vechainstats_get_nft_holdersA

Get list of NFT holders for a collection

Inputs: id (required), page, threshold.

vechainstats_get_nft_infoC

Get NFT collection information including floor price, volume, and holder count

Inputs: id (required), expanded.

vechainstats_get_nft_listB

Get list of all NFT collections on VeChain

Inputs: no named parameters.

vechainstats_get_nft_transfersC

Get NFT transfer history for an address

Inputs: address (required), page, sort.

vechainstats_get_node_token_statsC

Get VeChain node token statistics

Inputs: no named parameters.

vechainstats_get_token_holdersB

Get list of token holders with balances

Inputs: token (required), page, threshold.

vechainstats_get_token_infoA

Get detailed token information including supply, holders, and metadata

Inputs: token (required), expanded.

vechainstats_get_token_listA

Get comprehensive list of all tokens on VeChain with metadata

Inputs: no named parameters.

vechainstats_get_token_priceB

Get current token price in USD with 24h change and volume

Inputs: token (required), expanded.

vechainstats_get_token_supplyA

Get token supply information (total, circulating)

Inputs: token (required), expanded.

vechainstats_get_token_transfersB

Get token transfer history for an address (VET, VTHO, or VIP-180 tokens)

Inputs: address (required), page, sort, tokenType.

vechainstats_get_transaction_emissionsB

Get carbon emissions for a specific transaction

Inputs: txid, address, blocknum, timeframe.

vechainstats_get_transaction_infoB

Get detailed transaction information including clauses, events, and gas used

Inputs: txid (required).

vechainstats_get_transactions_inA

Get incoming transactions for an address with pagination

Inputs: address (required), page, sort.

vechainstats_get_transactions_outA

Get outgoing transactions for an address with pagination

Inputs: address (required), page, sort.

vechainstats_get_transaction_statusC

Get transaction status and confirmation info

Inputs: txid (required).

vechainstats_get_vip180_balanceB

Get VIP-180 token balance for a specific address and token contract

Inputs: address (required), contract, expanded.

vechainstats_get_xnode_listA

Get list of X-Nodes (economic nodes) on VeChain

Inputs: no named parameters.

xflows_build_transactionC

Build cross-chain swap transaction using XFlows (section 5)

Inputs: toAddress (required), toChainId (required), fromAmount (required), fromAddress (required), +6 more.

xflows_check_statusB

Check XFlows cross-chain swap status (section 6)

Inputs: hash (required).

xflows_get_quoteC

Get quote for cross-chain swap with DEX integration (XFlows API, section 4)

Inputs: toAddress (required), toChainId (required), fromAmount (required), fromAddress (required), +6 more.

xflows_get_supported_chainsA

Get all chains supported by XFlows (section 3.1)

Inputs: no named parameters.

xflows_get_supported_tokensB

Get all tokens supported by XFlows for a specific chain (section 3.2)

Inputs: chainId.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 92 tools

    Disambiguation1/5

    Multiple tools have overlapping functionality, e.g., nft_get_transfer_history and vechainstats_get_nft_transfers both retrieve NFT transfer history, and get_token_info vs vechainstats_get_token_info are nearly identical. The sheer number of similar getters makes it difficult for an agent to select the correct tool.

    Naming Consistency2/5

    Naming is inconsistent: some tools use a namespace prefix (vechainstats_, nft_, bridge_), others are bare verbs (stake_vet, sign_message, transfer_vet). No uniform verb_noun pattern, and similar operations are named differently across domains (e.g., get_user_stakes vs nft_get_owned_tokens).

    Tool Count1/5

    With 92 tools, the server is dramatically over-scoped for a coherent toolkit. This is far beyond the typical 3-15 well-chosen tools and even exceeds the 25+ threshold for a heavy set.

    Completeness3/5

    The server covers many domains (stats, NFT, DEX, bridge, wallet, VeBetter), but each domain has gaps. For example, NFT operations lack metadata updates, and VeBetter lacks submission status or cancellation. The extraordinary breadth means depth suffers, leaving some workflows incomplete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables read and write interactions with 60+ blockchain networks through Claude Desktop, providing a standardized multi-chain API for transaction management, account insights, staking, and token interactions.
      12
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the Stacks blockchain through Claude Desktop. Manage wallets, trade tokens on DEXs, stack STX for Bitcoin rewards, and track portfolio—all through natural conversation.
      6
      MIT