Requirements
Wasit is a Node command-line tool and an MCP server. There is nothing to compile, no native dependency, and no service to run.
Runtime
- Node.js 22 or newer. All three packages declare
"node": ">=22". - npm, which ships with Node.
- macOS, Linux, or Windows. Nothing in Wasit is platform-specific.
Continuous integration builds and tests on Node 22 and Node 24. Node 26 works too — the full build, typecheck and test suite has been run on it.
Note — Wasit is built for testnets: Stellar testnet by default, and Base Sepolia, Ethereum Sepolia and Solana devnet for the x402 payment checks. The one mainnet it can pay on is Stellar's, and only when you name
stellar:pubnetand pass your own--rpc-url: there is no default endpoint for it, so it cannot be reached by accident. Do not do this; see the Security Policy.
A testnet account
Only for the checks that move money. The read-only x402 checks
(X402-01–05) need no key, no funds, and no account — that is the
whole point of starting there.
This table is about what you have to obtain. For the authoritative
list of which environment variable each check reads — including
MPP_STELLAR_NETWORK and the extra opt-in MPP-13 needs — see
What each check needs.
| You want to run | You need to have |
|---|---|
X402-01–05 | Nothing at all |
X402-06–10 on Stellar | A testnet account funded with XLM and the asset the target charges in, usually USDC |
X402-06–10 on Base Sepolia, Ethereum Sepolia or Solana devnet | A key holding that network's USDC, and nothing else: the facilitator pays the fee |
MPP-01 | A testnet account funded with XLM and USDC |
MPP-10–14 | A commitment signing key — no funds, no account |
wasit wallet create generates any of these and wasit wallet fund
funds the Stellar ones from Friendbot; --network makes the key for
another testnet, whose USDC comes from Circle's faucet — see
Quick setup.
AI clients, for the MCP server
The MCP server speaks stdio, so it needs a client that can launch a local server process. A client that only supports remote HTTP connectors cannot run it at all.
| Client | Works with Wasit |
|---|---|
| Claude Code | Verified — exact claude mcp add command in the MCP Guide |
| Claude Desktop | Verified — config file snippet in the MCP Guide |
| VS Code (GitHub Copilot) | Compatible, not yet verified — supports local stdio servers |
| Cursor | Compatible, not yet verified — supports local stdio servers |
| ChatGPT | Not compatible — its connectors are remote HTTP only |
Note — "Verified" means the exact steps in the MCP Guide were run against this package. "Compatible, not yet verified" means the client documents support for local stdio MCP servers, which is all Wasit needs, but nobody has run it there yet. If you do, the repo would welcome the report.
The CLI needs none of this. Only the MCP server does.