ATXP Tools

Access ATXP's paid API tools via CLI.

Authentication

# Check if authenticated
echo $ATXP_CONNECTION

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

Commands

Command	Description
npx atxp search <query>	Real-time web search
npx atxp image <prompt>	AI image generation
npx atxp music <prompt>	AI music generation
npx atxp video <prompt>	AI video generation
npx atxp x <query>	X/Twitter search
npx atxp email inbox	Check 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-username	Release your username (FREE)
npx atxp balance	Check your ATXP account balance (FREE)
npx atxp fund	Show how to fund your account (FREE)
npx atxp whoami	Show account info (ID, type, email, wallet) (FREE)
npx atxp topup	Create 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 create	Create a new agent account (requires human login)
npx atxp agent list	List your agents (requires human login)
npx atxp agent register	Self-register as an agent (no login required)

Balance

Check your ATXP account balance:

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.

npx atxp fund

Account Info

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

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.

npx atxp login
npx atxp agent create

Self-Register as an Agent

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

npx atxp agent register

List Your Agents

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).

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:

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

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

npx atxp email release-username

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

Check Inbox

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

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

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:

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

Reply to Email

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

npx atxp email search <query>

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

Delete Email

npx atxp email delete <messageId>

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

Get Attachment

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:

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.

Codex Environment

If routing ATXP model access from Codex, keep provider credentials and routing config in your normal Codex configuration or shell environment. Edit local configuration files carefully and do not expose tokens in prompts or logs.

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

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

Server	Tools
search.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.ai	PaaS tools (see atxp-paas skill)