We use necessary cookies for site function. For analytics and marketing, we need your consent. You can change your mind anytime. Privacy Policy

One binary for the whole Stellar workflow — from wallet to WASM deploy to ISO 20022 report
Stellar · Go · CLI

Stellar Go CLI: Wallets, Payments, DIDs, ISO 20022 & AI Agents — One Binary

Olvis GilOlvis Gil  ·  November 16, 2026  ·  8 min read

Most Stellar tooling does one thing. stellar-go-cli is the opposite bet: a single Apache-2.0 Go binary that covers wallets, payments, DEX swaps, SEP-41 assets, W3C DIDs and Verifiable Credentials, ISO 20022 reporting, a pure-Go Soroban RPC client, and an MCP server that hands the same powers to AI assistants. It runs against mainnet and testnet today — and unlike most CLIs, every feature also exists as a reusable Go package under pkg/.

Install in one line

# Homebrew
brew install stellar-go-cli/tap/stellar-go-cli

# go install (needs a release after v0.6.0 — see note below)
go install github.com/stellar-go-cli/stellar-go-cli/cmd/stellar-go-cli@latest

# Or grab a signed binary — every release ships checksums,
# a CycloneDX SBOM, and a cosign signature bundle
cosign verify-blob --bundle stellar-go-cli_<ver>_checksums.txt.bundle \
  --certificate-identity-regexp 'github.com/stellar-go-cli' \
  stellar-go-cli_<ver>_checksums.txt

One honest caveat from the README: go install …@latest currently fails on v0.6.0 because that tag’s go.mod contained a replace directive Go rejects for remote installs — use Homebrew, a release binary, or git clone && make install until the next tag lands. Docker images (CLI, MCP server, VC API) are published to GHCR on every release.

The sixty-second tour

stellar-go-cli init                                       # ~/.stellar-go-cli/config.json
stellar-go-cli wallet connect --provider stellar --network stellar-testnet
stellar-go-cli wallet fund --network stellar-testnet      # friendbot top-up

stellar-go-cli pay send --to G... --amount 10 --asset USDC
stellar-go-cli swap quote --from XLM --to USDC --amount 25
stellar-go-cli contract deploy --wasm my_contract.wasm --network stellar-testnet
stellar-go-cli contract invoke --id C... --method symbol --simulate

stellar-go-cli did create --method key
stellar-go-cli did attest --name "Your Name" --country AT
stellar-go-cli report iso20022 --type pacs.008 > report.xml
stellar-go-cli mcp                                        # MCP server over stdio

What it actually covers

Wallets — create/import seeds, faucet funding, and optional passkey (WebAuthn) protection that encrypts the seed at rest and gates signing behind a biometric or hardware assertion. Payments — direct sends, FX quotes, and an x402 pay-per-use flow. Swaps — path-payment quotes and execution on the Stellar DEX, plus trading strategies behind the extras build tag. Assets — SEP-41 fungible tokens and non-fungible assets via the Stellar Asset Contract, trustlines, claimable balances, liquidity pools.

Soroban — deploy any .wasm and invoke methods from a pure-Go RPC client; no stellar CLI required. DIDs & VCs — create did:web/did:key/did:ethr/did:ebsi documents and issue and verify W3C Verifiable Credentials (Ed25519Signature2020 and ES256 JsonWebSignature2020). ISO 20022 — export transactions as pacs.008/002/004/009 XML, or use pkg/iso20022 to build batch pain.001 disbursements, pain.002 status reports, and camt.053/054 statements — validated against the official XSDs.

The MCP angle: Stellar for AI agents

stellar-go-cli mcp exposes the toolset over stdio or SSE —wallet_balance, pay_send, swap_quote, swap_execute, contract calls, system health — so Claude-style assistants can operate a wallet directly. The project is unusually candid about the security implications: a published policy-engine spec and signer-architecture roadmap for separating the MCP server from key custody, plus differential-fuzzing and TLA+ formal-verification roadmaps under docs/audit/.

Use it as a library, not just a CLI

Every feature doubles as an importable package on pkg.go.dev: pkg/soroban (the pure-Go RPC client — deploy, invoke, simulate, events), pkg/iso20022 (the full message family), pkg/vc (DIDs and credentials), pkg/swap, pkg/x402, and shared pkg/models/pkg/crypto. MozartPay’s Orchestrated Agreements is already a downstream consumer of exactly these packages.

Worth knowing before you bet on it

Three honest limitations from the project itself: it is not an SDF project; self-issued VCs prove key control, not KYC’d identity (an external issuer can be configured); and did:ethr/did:ebsi identifiers are locally derived — cryptographically verifiable, but never anchored to a registry. Wallets, payments, and swaps run against mainnet and testnet; DID/VC and ISO 20022 are flagged as working prototypes.

Keep learning

stellar-go-cli on GitHub · pkg/ docs on pkg.go.dev · Build Stellar apps with Go · The Stellar C++ SDK · Bell, Protocol 30 · Stellar Network masterclass

Frequently asked questions

What is stellar-go-cli?
An open-source (Apache 2.0) command-line tool for Stellar written in Go. It manages wallets, sends payments, executes DEX swaps, deploys and invokes Soroban contracts, creates W3C DIDs and Verifiable Credentials, exports ISO 20022 XML reports, and can run as an MCP server for AI assistants.
How do I install it?
With Homebrew (`brew install stellar-go-cli/tap/stellar-go-cli`), `go install` (needs a release after v0.6.0), prebuilt cosign-signed binaries for Linux/macOS/Windows from GitHub Releases, or Docker images on GHCR.
Can AI assistants use it?
Yes — `stellar-go-cli mcp` starts an MCP server over stdio or SSE exposing tools like wallet_balance, pay_send, swap_quote, and contract invocation. A documented signer-architecture roadmap separates the MCP server from key custody.
Is it an official Stellar Development Foundation project?
No — it is a community project. The codebase was extracted from a downstream commercial product (MozartPay is its first consumer), runs against mainnet and testnet for wallets/payments/swaps, and marks DID/VC and ISO 20022 features as working prototypes.
Can I use it as a Go library instead of a CLI?
Yes. The reusable packages live under pkg/ and render on pkg.go.dev — including a pure-Go Soroban RPC client, ISO 20022 message builders, a DID/VC package, DEX swap logic, and an x402 client/facilitator.
Share this article
Olvis Gil
Olvis Gil

Founder of EduNode and OG Technologies EU — a Vienna consultancy for blockchain payments, tokenization, digital identity, and ISO 20022.