Skip to main content

​
ATXP Skill

The ATXP skill gives AI agents access to paid API tools for web search, AI image generation, music creation, video generation, and X/Twitter search. It works with any agent that supports the Agent Skills specification.
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.

​
Installation

Install the skill using the skills CLI: 
npx skills add atxp-dev/cli
Or manually copy the skill to your agent’s skills directory: 
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: 
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: 
source ~/.atxp/config
New terminal windows will automatically have access after login.
Never share your connection string publicly or commit it to source control.

​
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: 
npx atxp login --qr
Or provide a token directly for fully headless authentication: 
npx atxp login --token <your-token>

​
Available commands

Once authenticated, use these CLI commands:
CommandDescription
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

​
Examples

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

​
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
The agent will use the appropriate npx atxp command based on your request.

​
Programmatic access

For building applications, use the @atxp/client package: 
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:
ServerTool
search.mcp.atxp.aisearch_search
image.mcp.atxp.aiimage_create_image
music.mcp.atxp.aimusic_create
video.mcp.atxp.aicreate_video
x-live-search.mcp.atxp.aix_live_search
paas.mcp.atxp.aiPaaS tools (functions, databases, storage)
See the full tool catalog 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

Verify authentication:
echo $ATXP_CONNECTION
If empty, run npx atxp login and then source ~/.atxp/config in your current session.
Ensure you have Node.js installed and npx is available in your PATH. The ATXP CLI runs via npx without requiring global installation.
  • Ensure your ATXP account is active at accounts.atxp.ai
  • Check organization limits or quotas
  • Re-run npx atxp login --force to refresh your connection string

​
Learn more