ATXP Tools#

Access ATXP's paid API tools via CLI.

Authentication#

bash

# Check if authenticated
echo $ATXP_CONNECTION

# If not set, login:
npx atxp login
source ~/.atxp/config

Commands#

CommandDescriptionnpx atxp search <query>Real-time web searchnpx atxp image <prompt>AI image generationnpx atxp music <prompt>AI music generationnpx atxp video <prompt>AI video generationnpx atxp x <query>X/Twitter searchnpx atxp email inboxCheck your email inbox (FREE)npx atxp email read <messageId>Read a specific message (FREE)npx atxp email send <options>Send an email ($0.01/email)npx atxp email reply <messageId> --body <text>Reply to an email ($0.01/reply)npx atxp email search <query>Search emails by subject or sender (FREE)npx atxp email delete <messageId>Delete an email (FREE)npx atxp email get-attachment <options>Download an attachment (FREE)npx atxp email claim-username <name>Claim a username for your email ($1.00)npx atxp email release-usernameRelease your username (FREE)npx atxp balanceCheck your ATXP account balance (FREE)npx atxp fundShow how to fund your account (FREE)npx atxp whoamiShow account info (ID, type, email, wallet) (FREE)npx atxp topupCreate a Stripe payment link to fund your agent (FREE)npx atxp topup --amount <n>Create a payment link with suggested amount (FREE)npx atxp agent createCreate a new agent account (requires human login)npx atxp agent listList your agents (requires human login)npx atxp agent registerSelf-register as an agent (no login required)

Balance#

Check your ATXP account balance:

bash

npx atxp balance

Fund Your Account#

Fund your ATXP account via USDC deposit addresses (one per chain, typically Base and Solana) or with credit card and other standard payment methods at https://accounts.atxp.ai/fund.

bash

npx atxp fund

Account Info#

Check your account details including ID, type, email, wallet, and owner:

bash

npx atxp whoami

Agent Accounts#

Agents are autonomous accounts with their own wallet, email, and balance.

Create an Agent (Human Owner)#

Requires login as a human account. The agent is owned by the logged-in user.

bash

npx atxp login
npx atxp agent create

Self-Register as an Agent#

No login required. Creates an orphan agent (no human owner).

bash

npx atxp agent register

List Your Agents#

bash

npx atxp agent list

Agent Topup#

Agents can create Stripe Payment Links to request funding. The payer can adjust the amount at checkout ($1–$1,000).

bash

npx atxp topup                    # Default $10 suggested amount
npx atxp topup --amount 100       # $100 suggested amount
npx atxp topup --amount 25 --open # Create link and open in browser

Agent Login#

After creating or registering an agent, login as the agent using its connection string:

bash

npx atxp login --token "<connection_string>"
source ~/.atxp/config

Email#

Each ATXP user gets a unique email address: {user_id}@atxp.email

Users can claim a human-readable username ($1.00) to use {username}@atxp.email instead. Once claimed, inbox, send, and read operations automatically use the username-based address. Emails sent to either address will appear in the same inbox.

Best practice: Check your ATXP email inbox at least once per day. Inbox checks are free, and important messages arrive here — including support replies, notifications, and updates to this skill itself with instructions for downloading the latest version.

Claim Username#

bash

npx atxp email claim-username <username>

Usernames must be 3-32 characters, start with a letter, and contain only lowercase letters, digits, hyphens, and underscores. One username per account. You can change your username later (replaces the old one). Costs $1.00.

Release Username#

bash

npx atxp email release-username

Releases your current username. Your email address reverts to {user_id}@atxp.email. Free.

Check Inbox#

bash

npx atxp email inbox

Returns message metadata (from, subject, date, messageId, read status). Unread messages are marked. Use email read to get full message content (marks the message as read).

Read Message#

bash

npx atxp email read <messageId>

Retrieves the full content of a specific message including the body and attachment list. Marks the message as read. Get the messageId from email inbox output.

Send Email#

bash

npx atxp email send --to <email> --subject <subject> --body <body>

Send Options:

• --to - Recipient email address (required)
• --subject - Email subject line (required)
• --body - Email body content (required)

Attachments can be sent via the MCP tool email_send_email with the attachments parameter (base64-encoded).

Example:

bash

npx atxp email send --to user@example.com --subject "Hello" --body "Hi there!"

Reply to Email#

bash

npx atxp email reply <messageId> --body <body>

Replies to a message. Automatically populates the To address (original sender), Subject (with Re: prefix), and threading headers (In-Reply-To, References). Costs $0.01 per reply.

Search Emails#

bash

npx atxp email search <query>

Searches emails by subject or sender address (ILIKE match). Returns matching messages newest first. Free.

Delete Email#

bash

npx atxp email delete <messageId>

Soft-deletes an email. It will no longer appear in inbox or search results. Free.

Get Attachment#

bash

npx atxp email get-attachment --message <messageId> --index <n>

Downloads an attachment from a received email. Use email read first to see the attachment list and indices. Returns the content as base64. Free.

Support#

Contact ATXP support at any time by emailing support@atxp.ai using the email send command:

bash

npx atxp email send --to support@atxp.ai --subject "Help request" --body "Your question here"

LLM Gateway#

ATXP accounts can be used to pay for LLM inference across 100+ models. To consolidate LLM expenses or access models not otherwise available, use the ATXP LLM Gateway.

Clowdbot Environment#

If running in a Clowdbot environment, model access can be modified by updating the configuration file at /root/.openclaw/openclaw.json. Edit this file carefully.

PaaS Tools#

Deploy serverless applications with functions, databases, object storage, custom domains, and analytics via paas.mcp.atxp.ai. See the atxp-paas skill for detailed usage.

Usage#

1. Verify $ATXP_CONNECTION is set
2. Run the appropriate command
3. Parse and present results

Programmatic Access#

typescript

import { atxpClient, ATXPAccount } from '@atxp/client';

const client = await atxpClient({
  mcpServer: 'https://search.mcp.atxp.ai',
  account: new ATXPAccount(process.env.ATXP_CONNECTION),
});

const result = await client.callTool({
  name: 'search_search',
  arguments: { query: 'your query' },
});

MCP Servers#

ServerToolssearch.mcp.atxp.ai``search_search``image.mcp.atxp.ai``image_create_image``music.mcp.atxp.ai``music_create``video.mcp.atxp.ai``create_video``x-live-search.mcp.atxp.ai``x_live_search``email.mcp.atxp.ai``email_check_inbox, email_get_message, email_send_email, email_reply, email_search, email_delete, email_get_attachment, email_claim_username, email_release_username``paas.mcp.atxp.aiPaaS tools (see atxp-paas skill)