atxp

# 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 | 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: ```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](https://docs.atxp.ai/agents/llm-gateway). ## Clowdbot Environment If running in a [Clowdbot](https://clowd.bot) 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 | 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) |