Skip to content

atxp-dev/atxp

Repository files navigation

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.

Links

License

MIT

About

Give your AI agent a wallet, email, phone number, and instant access to paid MCP tools — web search, image/video/music gen, X search, SMS, voice calls, code execution, and more. Works with Gemini CLI, Claude, and any MCP client.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors