Skip to main content

​
Quickstart

Start with the path that matches your setup.

​
Path 1: Non-technical users

If you just want PIXA inside Claude Desktop:
  1. Install Claude Desktop.
  2. Download the latest .mcpb bundle from the repo releases.
  3. Drag and drop the .mcpb file into Claude Desktop.
  4. Open the PIXA tools panel.
  5. Connect your wallet and start using the wallet tools.
This path is the simplest option for demos and non-technical users.

​
Path 2: Developers

If you want the npm package:
  1. Install Node.js 18 or newer.
  2. Add PIXA to your Claude MCP config using npx.
  3. Set your Algorand mnemonic and spending limits.
  4. Restart Claude Desktop.
  5. Call tools like check_balance, pay, and x402_fetch.
Use this package name: 
{
  "mcpServers": {
    "pixa": {
      "command": "npx",
      "args": ["-y", "pixa-wallet-mcp"],
      "env": {
        "ALGORAND_MNEMONIC": "your 25-word mnemonic here",
        "NETWORK": "algorand-mainnet",
        "MAX_PER_CALL": "0.10",
        "MAX_PER_DAY": "20.00"
      }
    }
  }
}

​
What to try first

After install, the best first checks are:
  1. check_balance
  2. request_funding
  3. pay
  4. x402_fetch
  5. open_onramp
If you are testing rekey and session behavior, do that in a browser flow first and then connect it back to the MCP layer.

​
What you should already have

  • Claude Desktop installed
  • a funded Algorand wallet or testnet wallet
  • the published npm package or the .mcpb bundle
  • a clear spending limit
That is enough to get PIXA running.