> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tentaclepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> A command-line wallet built for autonomous agents on Sui.

`tpay` is a wallet your agent holds and spends on its own. It keeps a Sui keypair in your OS keychain, enforces the limits you set, and turns any x402 paywall into a transparent retry — no human at the checkout.

```sh theme={null}
# Without tpay: the agent hits a paywall and stalls
$ curl https://api.weather.ai/forecast
HTTP/1.1 402 Payment Required

# With tpay: the payment settles and the request clears
$ tpay curl https://api.weather.ai/forecast
HTTP/1.1 200 OK
{ "location": "Tokyo, Japan", "temperature": "26°C", "forecast": "Humid & warm" }
```

## What you get

<CardGroup cols={2}>
  <Card title="Made for agents" icon="robot">
    Your agent holds the wallet and pays on its own. No human in the loop, no API keys to manage.
  </Card>

  <Card title="Rules it can't break" icon="shield-check">
    Set the limits. The wallet enforces them on every spend, and asks for your approval before signing.
  </Card>

  <Card title="Gasless on Sui" icon="gas-pump">
    Pay in Sui stablecoins. Sui covers gas for stablecoin transfers natively and the facilitator sponsors the rest, so every payment costs only the price of the call.
  </Card>

  <Card title="Pay across chains" icon="route">
    Pay in Sui — settle on the destination chain. One wallet for every service your agent uses.
  </Card>
</CardGroup>

## Two ways to use it

`tpay` meets your agent wherever it runs:

* **As a CLI** — `tpay curl` is a drop-in for `curl`. It forwards every flag, and when a server replies `402 Payment Required` it settles the payment and retries the request automatically. Wire it into any agent that can run a shell command.
* **As an MCP server** — `tpay mcp` exposes the active wallet to agents over the [Model Context Protocol](https://modelcontextprotocol.io) with two tools: `pay` and `get_balance`. Use `tpay claude` to launch Claude with the wallet already connected. See [Agents](/wallet/agents).

## Approval and key storage

The secret key lives in your operating system's keychain, never in a plaintext file. Before any payment is signed, `tpay` asks you to approve it — on macOS that's a Touch ID prompt. An agent can request a payment, but it settles only after you authorize it.

<Note>
  `tpay` ships prebuilt binaries for macOS (Apple Silicon and Intel) and Linux (x64 and arm64). Secure keychain storage with biometric approval is available on macOS today.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Get started" icon="terminal" href="/wallet/get-started">
    Install `tpay`, create a wallet, and make your first payment.
  </Card>

  <Card title="Connect an agent" icon="robot" href="/wallet/agents">
    Expose the wallet to Claude and other MCP clients.
  </Card>
</CardGroup>