# leandrogavidia-vechain-mcp-server

Connects your AI assistant to the VeChain network. It queries Thor REST API endpoints and manages on-chain wallet signatures.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: leandrogavidia
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/leandrogavidia/vechain-mcp-server
- Updated: 2025-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/leandrogavidia-vechain-mcp-server

## What it does

This server connects agents to VeChain. It communicates with the Thor REST API across both Mainnet and Testnet setups. Through provided tools, the agent inspects blocks, reads account states, and queries fee suggestions.

The integration also includes Goat SDK tools for wallet management. It can generate mnemonics, calculate unit conversions, approve ERC-20 allowances, and transfer tokens. Signing tasks cover canonical certificates, raw transactions, and EIP-712 typed payloads.

Signing features fail immediately unless `AGENT_SECRET_KEY` is present in the environment configuration. The server runs either as a local process via stdio or as an HTTP stream hosted on Smithery.

## Requirements
- Remote server: `https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http leandrogavidia-vechain-mcp-server https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add leandrogavidia-vechain-mcp-server --url https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "leandrogavidia-vechain-mcp-server": {
            "url": "https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "leandrogavidia-vechain-mcp-server": {
            "type": "http",
            "url": "https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http leandrogavidia-vechain-mcp-server https://server.smithery.ai/@leandrogavidia/vechain-mcp-server/mcp
```

## When to use it
- inspect block details and account states on VeChain
- search official VeChain developer guides from the agent prompt
- generate keypairs and sign EIP-712 structured messages
- manage ERC-20 token allowances and native asset transfers

## Example prompts
- Check the native token balance for address 0x0000000000000000000000000000000000000000 on VeChain
- Search the VeChain documentation for fee delegation details
- Generate a new VeChain wallet with mnemonic keys

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md