Nexa MCP: AI Agents on the Blockchain

Developers
, , ,
1

Nexa MCP: AI Agents on the Blockchain
Nexa MCP: AI Agents on the Blockchain1280×720 67.1 KB

It’s exciting to present the initial release of Nexa MCP, a Model Context Protocol (MCP) server that lets AI agents interact with the Nexa blockchain. Agents with Nexa MCP can read the blockchain, send and receive NEXA coins and tokens, create and manage tokens, and much more.

This is the first release of Nexa MCP, and it is already available on GitLab and compatible with Claude Code, Claude Desktop, Cursor, Codex, and other MCP clients.

Nexa MCP:

https://gitlab.com/nexa/nexa-mcp

Quick Start

You need JDK 21 and Gradle 8.14 or newer. Gradle downloads everything else, including libnexakotlin.

git clone https://gitlab.com/nexa/nexa-mcp.git
cd nexa-mcp
gradle installDist

Then add it to Claude Code:

claude mcp add nexa -e NEXA_NETWORK=testnet -- /path/to/nexa-mcp/build/install/nexa-mcp/bin/nexa-mcp

That’s all an agent needs on testnet: the server creates its wallet, and the agent calls nexa_request_faucet and then nexa_wallet_balance to start paying.

The faucet also works on mainnet. The model never sees the seed phrase or private keys. Mainnet sending stays off until you set a per-payment limit. Nexa MCP is written in Kotlin on libnexakotlin (wallet, transaction building, and the light client), the MCP Kotlin SDK, and ktor.

Agent-to-Agent Payments

  1. The seller calls nexa_wallet_receive_address with the price and gives the buyer the address, or the payment URI if the buyer is a human with a Nexa wallet.

  2. The buyer calls nexa_send with that address and amount.

  3. The seller calls nexa_check_payment until paid is true, then delivers.

For a token price, the buyer calls nexa_send_token, and the seller calls nexa_check_token_payment, both with the token ID.

Features

  • Read the chain. Block height, address balances and history, full transactions, address validation, and token, NFT, and SFT metadata. It works without a wallet.

  • A wallet that sets itself up. Without a seed, the server creates and keeps its own wallet file.

  • Get funds. One call claims NEXA from the official testnet or mainnet faucet into the server’s own wallet.

  • Get paid. Receive addresses with an optional payment URI, and payment checks for NEXA and tokens that count confirmed funds only, unless asked otherwise.

  • Pay in NEXA and tokens. nexa_send and nexa_send_token, each with a dryRun fee preview and an optional public memo on NEXA payments.

  • Holder snapshots. A reproducible list of every holder of a token or NFT collection at any block height.

  • Airdrops. Fixed or proportional airdrops to the holders of another token. They’re batched, dry-run by default, and resumable after a failed batch.

  • Token authorities (opt-in). List, mint, melt, renew, delegate, and delete authorities (batons) for the tokens you enable, with a 24h mint cap per token.

  • Create tokens (opt-in). Token genesis with a full-permission baton for the wallet.

  • Three networks. Testnet (the default), regtest for local testing, and mainnet only when chosen on purpose.

Safety Model

Every payment is checked against network prefix, allowlist, per-payment limit, and 24h limit before it is signed. Token sending is off for every token until you list it in NEXA_TOKEN_LIMITS, on every network.

A token send never spends or moves a token authority, the MINT/MELT/BATON UTXOs that control a token. Before signing, the server checks the built transaction: no input may be one of the wallet’s authority outpoints, no output may be an authority, no other token may move, and the recipient must get the amount asked. Any step that would lose or give away a baton needs explicit confirmation.

To Wrap Up

With Nexa MCP, AI agents can now interact with the Nexa blockchain and each other, provide services, and get rewarded on-chain. As AI improves and adoption widens, this was a natural next step, in line with the latest trends in the IT industry.

Combined with the Nexa Programming Language (NPL) and the tools prepared for AI-assisted development, Nexa MCP closes the loop. It fully opens the gates for next-generation blockchain interactions.

Nexa MCP was developed by B.U. developer Jørgen Notland, and we are grateful for all his phenomenal contributions to building Nexa.
​

Read More

1 Like