# Aether testnet wallet

> Aether testnet wallet is an open-source MCP server for finance and payments. Testnet wallet giving AI agents spend-capped AETH payments and paid API access. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, API
- **Repository:** https://github.com/whoyoujoshin/aether
- **MCP Registry name:** io.github.whoyoujoshin/aether-wallet
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-18

## About

The README says Aether is a proof-of-work chain, and this wallet is the MCP server that lets an agent hold a testnet balance, send and receive AETH and buy from HTTP 402 paid APIs. Spending is limited per transaction and per rolling day by the server itself, so an operator sets the ceiling rather than the agent.

An agent can create an invoice and wait for a matching confirmed payment, or send with an idempotency key so retries never pay twice. A grant mode instead spends from an owner's account under an on-chain authz allowance that the chain enforces and the owner can revoke. Larger payments can be held until the owner signs an approval with their own key.

The README states the chain has no independent security audit and that it is for disposable test funds only. It suits developers and agent builders experimenting with machine-to-machine payments on the testnet.

## Features

- **Capped hot wallet:** A dedicated agent account whose per-transaction and daily spending the server enforces.
- **On-chain grant mode:** Spends from an owner's account under an authz allowance with a limit, expiry and allowed recipients.
- **Idempotent sends:** Retries with the same key re-send the identical signed transaction, which can land at most once.
- **Invoices and payment waiting:** Creates memo-tagged invoices and waits for a confirmed incoming payment that matches.
- **Paid API purchases:** Requests a URL, pays an HTTP 402 invoice up to a stated maximum and returns the response.
- **Owner approval threshold:** Holds payments above a set amount until the owner approves them with a separate key.

## Good for

- Letting an agent pay for HTTP 402 APIs on the Aether testnet within a fixed budget
- Testing agent-to-agent payments and escrow before any real funds are involved
- Giving an agent a disposable wallet that can be topped up from the testnet faucet
- Having an owner pre-approve an agent's spending via an on-chain allowance

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http aether-wallet https://explorer.157-245-252-221.sslip.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://explorer.157-245-252-221.sslip.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aether-wallet": {
      "url": "https://explorer.157-245-252-221.sslip.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aether-wallet": {
      "type": "http",
      "url": "https://explorer.157-245-252-221.sslip.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aether-wallet": {
      "serverUrl": "https://explorer.157-245-252-221.sslip.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aether-wallet": {
      "type": "http",
      "url": "https://explorer.157-245-252-221.sslip.io/mcp"
    }
  }
}
```

## Tools

- `send_aeth`: Sends AETH with an idempotency key, under the server's spending limits.
- `create_invoice`: Creates an invoice with a unique memo and the current height.
- `wait_for_payment`: Waits for a confirmed incoming payment matching a memo and minimum amount.
- `fetch_paid`: Requests a URL and pays an HTTP 402 invoice up to a maximum amount.
- `find_services`: Lists paid APIs from the on-chain service directory.
- `create_escrow`: Locks AETH for a payee until released, refunded or expired.
- `get_balance`: Returns the wallet balance.
- `request_testnet_funds`: Requests testnet funds from the faucet.

## FAQ

### Is this wallet for real money?

No. The README says it is testnet only, for disposable keys and funds of no value, and the chain has not had an independent security audit.

### How does the spending limit work?

In hot wallet mode the server enforces per-transaction and rolling 24-hour caps, not the chain. In grant mode the chain enforces the limit, expiry and allowed recipients through x/authz.

### Can a retried payment be charged twice?

The README says send_aeth requires an idempotencyKey and a retry with the same key re-sends the identical signed transaction, which the chain can include at most once.

### How is it installed?

The README gives a Go install command for agentmcp, and an mcpb bundle on the releases page for Claude Desktop without Go.

### Is Aether testnet wallet free?

Yes. Aether testnet wallet is open source, so you can use and self-host it for free.

### How do I add Aether testnet wallet to Claude Code?

Run this command in your terminal: claude mcp add --transport http aether-wallet https://explorer.157-245-252-221.sslip.io/mcp

### What are the best alternatives to Aether testnet wallet?

The closest alternatives to Aether testnet wallet are 16ane sandbox wallet, Agentgates Wallet, AgentLedger, Pink Agentic AI Payments and AgentPay — trust routing + spend caps for x402 agents.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [16ane sandbox wallet](https://ai-powered.com/mcp/16ane-sandbox-wallet): 16ane sandbox wallet is an open-source MCP server for finance and payments.
- [Agentgates Wallet](https://ai-powered.com/mcp/agentgates-wallet): Agentgates Wallet is a paid MCP server for finance and payments.
- [AgentLedger](https://ai-powered.com/mcp/agentledger): AgentLedger is a freemium MCP server for finance and payments.
- [Pink Agentic AI Payments](https://ai-powered.com/mcp/pink-agentic-ai-payments): Pink Agentic AI Payments is a freemium MCP server for finance and payments.
- [AgentPay — trust routing + spend caps for x402 agents](https://ai-powered.com/mcp/agentpay-trust-routing-spend-caps-for-x402-agents): AgentPay — trust routing + spend caps for x402 agents is a freemium MCP server for finance and payments.
- [x402Shield](https://ai-powered.com/mcp/x402shield): x402Shield is an MCP server for finance and payments.
- [AIC — agent-native credits (read-only)](https://ai-powered.com/mcp/aic-agent-native-credits-read-only): AIC — agent-native credits (read-only) is a free MCP server for finance and payments.
- [AgentCoin router + escrow (Base Sepolia testnet)](https://ai-powered.com/mcp/agentcoin-router-escrow-base-sepolia-testnet): AgentCoin router + escrow (Base Sepolia testnet) is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/aether-testnet-wallet
