MultiversX

MCP Server for MultiversX

typescript

1

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "multiversx-mx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@multiversx/mcp"
      ],
      "env": {
        "MVX_WALLET": "absolute/path/to/someWallet.pem",
        "MVX_NETWORK": "devnet"
      }
    }
  }
}

You have an MCP server for MultiversX that lets you create PEM wallets, retrieve wallet addresses, check balances, and send tokens across EGLD, fungible tokens, SFTs, NFTs, and MetaESDTs. It also supports issuing tokens and interacting with wallets in a straightforward, programmable way through an MCP client.

How to use

You interact with the MultiversX MCP Server through an MCP client. Typical workflows include creating a PEM wallet, reading the wallet address, checking the balance of an address, and sending tokens. You can also issue new tokens when needed. Use the client to specify which network you want to interact with by setting MVX_NETWORK in your environment, and point the client to your wallet PEM file with MVX_WALLET.

How to install

Prerequisites you need before getting started:

Install Node.js and npm on your machine.
Ensure you have a wallet PEM file available at a path you can reference, and be prepared to set MVX_WALLET to that path.
Choose a deployment method (use an MCP client with a prebuilt server, or build from source as described below).

Additional sections

MCP server configuration is provided in code snippets you can copy and adapt. You can run the server via a local runtime or connect to a remote MCP endpoint as described in the examples.

{
  "mcpServers": {
    "multiversx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@multiversx/mcp"
      ],
      "env": {
        "MVX_NETWORK": "devnet",
        "MVX_WALLET": "absolute/path/to/someWallet.pem"
      }
    }
  }
}

Build from source

If you prefer building from source, follow these steps to produce a local MCP server you can run with Node.

Clone the repository, install dependencies, and build the project.

Then run the server locally and point your config to the built entry point.

{
  "mcpServers": {
    "multiversx-mcp": {
      "command": "node",
      "args": [
         "absolute/path/to/index.js"
      ],
      "env": {
        "MVX_NETWORK": "devnet",
        "MVX_WALLET": "absolute/path/to/someWallet.pem"
      }
    }
  }
}

Available tools

Create PEM wallet

Creates a PEM wallet at ~./multiversx/wallet.pem for use with the MCP server.

Get wallet address

Retrieves the wallet address currently configured in the environment.

Get balance

Fetches the balance for a specified address.

Send tokens

Sends EGLD, fungible tokens, SFTs, NFTs, or MetaESDTs to a recipient.

Issue tokens

Issues new tokens on the MultiversX network via the MCP server.