> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atxp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ATXP Skill

> Access ATXP paid API tools from any skills-compatible agent

# ATXP Skill

The ATXP skill gives AI agents access to paid API tools for web search, AI image generation, music creation, video generation, X/Twitter search, and email. It works with any agent that supports the [Agent Skills specification](https://agentskills.io/).

<Info>
  Agent Skills are an open standard for giving agents new capabilities. The ATXP skill is compatible with Claude Code, Cursor, VS Code agents, Gemini CLI, and [many other tools](https://agentskills.io/).
</Info>

## Installation

Install the skill using the skills CLI:

```bash theme={null}
npx skills add atxp-dev/cli
```

Or manually copy the skill to your agent's skills directory:

```bash theme={null}
git clone https://github.com/atxp-dev/cli.git
cp -r cli/skills/atxp ~/.claude/skills/   # For Claude Code
```

## Authentication

Before using ATXP tools, authenticate with your ATXP account:

```bash theme={null}
npx atxp login
```

This opens a browser for authentication and saves your connection string to `~/.atxp/config`. To use ATXP in your current terminal session:

```bash theme={null}
source ~/.atxp/config
```

New terminal windows will automatically have access after login.

<Warning>
  Never share your connection string publicly or commit it to source control.
</Warning>

### Headless environments

For SSH sessions, Docker containers, or CI environments, the CLI automatically falls back to QR code login. You can also force QR mode:

```bash theme={null}
npx atxp login --qr
```

Or provide a token directly for fully headless authentication:

```bash theme={null}
npx atxp login --token <your-token>
```

## Available commands

Once authenticated, use these CLI 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 <command>` | Send and receive emails |

### Examples

```bash theme={null}
# Web search
npx atxp search "latest AI research papers 2025"

# Generate an image
npx atxp image "a sunset over mountains at golden hour, photorealistic"

# Create music
npx atxp music "upbeat electronic track with synth leads"

# Generate video
npx atxp video "a cat playing piano, cartoon style"

# Search X/Twitter
npx atxp x "from:anthropic AI safety"

# Check your email inbox
npx atxp email inbox

# Read a specific message
npx atxp email read msg_abc123

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

## Using with agents

Once the skill is installed, agents can invoke ATXP tools automatically. Just ask naturally:

```
Search the web for the latest AI evaluation benchmarks and summarize with sources
```

```
Generate an image of a cozy coffee shop interior with warm lighting
```

```
Check my email inbox and summarize any new messages
```

```
Send an email to jane@example.com letting her know the report is ready
```

The agent will use the appropriate `npx atxp` command based on your request.

## Programmatic access

For building applications, use the `@atxp/client` package:

```typescript theme={null}
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

For direct MCP integration, connect to these servers:

| Server                      | Tool                                                         |
| --------------------------- | ------------------------------------------------------------ |
| `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` |
| `paas.mcp.atxp.ai`          | PaaS tools (functions, databases, storage)                   |

See the full [tool catalog](/tools) for details on each tool.

## How billing works

* All tool calls route through ATXP and are billed to your ATXP account
* No per-tool API keys required
* Pay-per-use pricing

## Troubleshooting

<AccordionGroup>
  <Accordion title="ATXP_CONNECTION not set">
    Verify authentication:

    ```bash theme={null}
    echo $ATXP_CONNECTION
    ```

    If empty, run `npx atxp login` and then `source ~/.atxp/config` in your current session.
  </Accordion>

  <Accordion title="Commands not found">
    Ensure you have Node.js installed and `npx` is available in your PATH. The ATXP CLI runs via `npx` without requiring global installation.
  </Accordion>

  <Accordion title="Authorization errors">
    * Ensure your ATXP account is active at [accounts.atxp.ai](https://accounts.atxp.ai)
    * Check organization limits or quotas
    * Re-run `npx atxp login --force` to refresh your connection string
  </Accordion>
</AccordionGroup>

## Learn more

* [ATXP CLI repository](https://github.com/atxp-dev/cli)
* [Agent Skills specification](https://agentskills.io/)
* [Tool catalog](/tools)