@iflow-mcp/atxp-dev-atxp

v1.0.0

Published

18 days ago

ATXP extension for Gemini CLI — wallet, email, and paid MCP tools for AI agents

0High
0Medium
0Low

chatflowdev

qystart

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 (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

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 / Cursor / Windsurf

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

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

Any MCP Client

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, set the ATXP_CONNECTION environment variable to your connection string, or pass it to the CLI:

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 | Description | |----------|-------|-------------| | Account | Register, Login, Whoami, Balance, Fund, Transactions | Self-register, check balance, get funding options | | Search | Web Search, X/Twitter Search | Real-time web and social search | | Media | Image, Video, Music | AI generation (returns URLs) | | Email | Inbox, Read, Send, Reply, Search, Delete, Attachments, Username | Full email with @atxp.email address | | Phone | Register, SMS, Send SMS, Voice Call, Call History, Search | SMS and AI-powered voice calls | | Contacts | Add, List, Show, Edit, Remove, Search, Push, Pull | Local contacts with cloud sync | | Agents | Create, List | Manage sub-agents |

Remote MCP Tools (Gemini CLI extension only, requires settings)

| Tool | Description | |------|-------------| | Browse | Fetch and read web page content | | Crawl | Crawl websites and extract structured data | | Research | Deep multi-source research and synthesis | | Code | Execute code in a sandbox | | File Store | Persistent cloud file storage | | Phone | SMS, voice calls via MCP proxy |

Usage

Just ask your agent naturally:

Search the web for the latest AI research papers

Generate an image of a sunset over mountains

Send an SMS to +1234567890 saying "Hello from my AI agent"

Check my ATXP email inbox

Run this Python script in a sandbox

The agent uses the appropriate ATXP tool automatically.

Managing Your Account

Use the built-in tools or the ATXP CLI:

npx atxp@latest balance          # Check balance
npx atxp@latest fund             # Show funding options
npx atxp@latest transactions     # View transaction history
npx atxp@latest whoami           # Show account info

Billing

All tools are pay-per-use, billed to your ATXP account in USDC. Typical costs:

| Action | Cost | |--------|------| | Web/X search, image gen | $0.001–$0.05 | | Send email | $0.01 | | Send SMS | $0.05 | | Voice call | $0.10 | | Claim email username | $1.00 | | Register phone number | $2.00 |

No subscriptions, no API keys to manage.

License

MIT