ATXP

SKILL.md

---
name: atxp
description: Access ATXP paid API tools for web search, AI image generation, music creation, video generation, X/Twitter search, email, and agent account management. Use when users need real-time web search, AI-generated media (images, music, video), X/Twitter search, send/receive emails, or create and fund agent accounts. Requires authentication via `npx atxp login`.
---

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