atxp

# ATXP — Agent Payment & Wallet Infrastructure

Give your AI agent a wallet, email, phone number, and instant access to paid MCP tools — web search, image/video/music generation, X/Twitter search, SMS, voice calls, code execution, file storage, and more.

[ATXP](https://atxp.ai) (Agent Transaction Protocol) lets AI agents pay for their own tools and services without managing API keys. Self-register in one command, pay per use. Works with any MCP client.

## Install

### Gemini CLI

```bash
gemini extensions install https://github.com/atxp-dev/atxp
```

> After installing, start a new Gemini CLI session for the extension tools to load.

### Claude Desktop / Gemini / Windsurf

Add to your MCP client config (e.g. `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "atxp": {
      "command": "npx",
      "args": ["-y", "atxp@latest"]
    }
  }
}
```

### Any MCP Client

```bash
npx atxp@latest
```

ATXP runs as a standard MCP server over stdio. Point any MCP-compatible client at the command above.

## Setup

### Option 1: Agent self-registration (recommended)

No browser, no human login needed. Just ask your agent:

```
Register me on ATXP so I can use paid tools
```

The agent calls the `atxp_register` tool, which creates an account instantly with:
- 10 IOU tokens to start
- A unique email address
- An Ethereum wallet
- A connection string (saved automatically)

No settings to configure — the agent is ready to use all tools immediately.

### Option 2: Use an existing ATXP account

If you already have an ATXP account from [accounts.atxp.ai](https://accounts.atxp.ai), set the `ATXP_CONNECTION` environment variable to your connection string, or pass it to the CLI:

```bash
ATXP_CONNECTION="https://accounts.atxp.ai?connection_token=<TOKEN>&account_id=<ACCOUNT_ID>" npx atxp@latest
```

For Gemini CLI, enter the token and account ID when prompted during extension setup.

## Available Tools

### Core Tools (41 tools, always available)

| Category | Tools | Descrip