# mcp-klever-vm

Feeds your coding agent Klever smart contract knowledge: code patterns, examples and checks for common mistakes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 31
- Author: klever-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/klever-io/mcp-klever-vm
- Updated: 2026-05-19
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-klever-vm

## What it does

mcp-klever-vm is an MCP server from klever-io aimed at Klever blockchain smart contract work. It serves a knowledge base built around the Klever VM SDK — code samples, practices, runtime behaviour. Your agent can query it by type, tag or contract type and gets back ranked results.

Under the hood sits a parser that pulls patterns and examples out of Klever contracts, a validator that flags common issues and anti-patterns, and scripts for deploying, upgrading and querying contracts. Storage runs in memory or on Redis, and the server can start as an HTTP API, an MCP stdio process or a hosted public service. The public endpoint `https://mcp.klever.org/mcp` is read-only: `add_context` and shell tools such as `init_klever_project` are switched off there. Need writes or project scaffolding? Run it yourself.

Transactions require the Klever SDK, installed through `scripts/install-sdk.sh` in the repo. A local build needs pnpm and a `.env` file covering mode, port and storage type. Set `STORAGE_TYPE=redis` without a reachable Redis and the server won't start, so check that value first.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.klever.org/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-klever-vm https://mcp.klever.org/mcp
```

2. **Platform CLI**
```bash
claude mcp add mcp-klever-vm -- npx -y @klever/mcp-server
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp-klever-vm --url https://mcp.klever.org/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp-klever-vm -- npx -y @klever/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-klever-vm": {
            "url": "https://mcp.klever.org/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-klever-vm": {
            "command": "npx",
            "args": [
                "-y",
                "@klever/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-klever-vm": {
            "type": "http",
            "url": "https://mcp.klever.org/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-klever-vm": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@klever/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-klever-vm https://mcp.klever.org/mcp
```

2. **Platform CLI**
```bash
gemini mcp add mcp-klever-vm npx -y @klever/mcp-server
```

## When to use it
- find Klever VM contract examples without digging through the SDK
- catch anti-patterns in a contract before deploying
- reuse storage and event patterns in a new contract
- deploy, upgrade and query a contract with ready scripts
- pull Klever API reference into the chat with your agent

## Example prompts
- Look up token handling examples in the Klever knowledge base and show how decimals are computed
- Check my contract for anti-patterns and tell me what to fix
- Write a deployment script for my contract using the Klever SDK

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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