VeChain

VeChain MCP Server is an MCP server tailored for the VeChain network. It enables you to query VeChain documentation, perform HTTP requests to the Thor REST API in both Mainnet and Testnet environments, and manage cryptographic signatures via an integrated wallet.

How to use

You interact with the VeChain MCP Server through an MCP-aware client. Use it to fetch VeChain documentation, retrieve account, block, and transaction data, estimate priority fees, and perform wallet-based signing operations. You can also work with VeChain tools to manage addresses, balances, and token information, or sign messages and data for secure interactions with the VeChain network.

How to install

Prerequisites you need before installation: Node.js and a compatible package manager (npm or pnpm). You should also have access to the server URL you will connect to via MCP.

Step by step, you can set up the VeChain MCP Server locally as follows:

# 1) Install dependencies (use npm or pnpm as you prefer)
npm install
# or
pnpm install

# 2) Build the server (if a build step is provided by the project)
pnpm run build
# or
pnpm run build

# 3) Start the server (using the configured runtime command)
pnpm run start
# or
pnpm run start

Configuration and security notes

Configure your MCP client to connect to the VeChain MCP Server using the provided HTTP endpoint. The connection example uses a remote MCP URL in an HTTP configuration. You can also supply environment variables to control the server’s behavior.

{
  "mcpServers": {
    "vechainMcp": {
      "url": "https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp",
      "type": "http",
      "args": []
    }
  }
}

Environment variables

These variables control server operation and security. Use placeholder values where needed.

# Global environment settings
AGENT_SECRET_KEY=YOUR_SECRET_KEY
ENVIRONMENT=mainnet|test
USE_STREAMABLE_HTTP=true|false
PORT=8080
HOST=0.0.0.0

Notes and troubleshooting

If you encounter connection issues, verify that the MCP endpoint URL is reachable and that environmental settings match your deployment environment. Ensure that the agent secret key is configured if you plan to use signing tools, and confirm that the server is started with the correct host and port when using streamable HTTP.

Available tools

search_documentation

Query VeChain documentation to retrieve up-to-date information and references.

get_account

Retrieve account details from the Thor REST API.

get_transaction

Retrieve a transaction by its ID from the Thor REST API.

get_block

Fetch a VeChain block by its identifier from the Thor REST API.

get_priority_fee

Obtain a suggested priority fee for transactions.

create_wallet

Create a VeChain wallet, generating a mnemonic and cryptographic keys.

sign_certificate

Create and sign a canonical certificate for VeChain operations.

sign_raw_transaction

Sign a raw VeChain transaction using the integrated wallet.

get_address

Obtain the wallet address.

get_chain

Determine the chain information for the wallet.

sign_message

Sign a message with the wallet for authentication or integrity checks.

get_balance

Query the wallet balance for native VeChain currency or a specified token.

get_token_info_by_ticker

Get token details such as contract address and decimals by ticker symbol.

convert_to_base_units

Convert a human-friendly amount to the smallest unit for a token.

convert_from_base_units

Convert from the smallest unit to a human-friendly amount.

sign_typed_data_evm

Sign an EIP-712 structured data payload (EVM-compatible).

get_token_allowance_evm

Query ERC20 token allowance for a spender in base units.

send_token

Send native currency or an ERC20 token to a recipient in base units.

approve_token_evm

Approve a token amount for a spender in base units.

revoke_token_approval_evm

Revoke ERC20 token approval for a spender by setting allowance to zero.