atxp

ATXP is an MCP server that provides an Agent Wallet with tools for payment-enabled access to a wide range of capabilities. Once loaded in an MCP client, ATXP exposes core tool categories such as Account management, Web/Search, Email, Phone/SMS and Voice, Media generation (image, video, music), and the ability to run code or manage files, all with pay-per-use billing via your ATXP account. The server is designed to let AI agents self-register, obtain an account, and then invoke tools without manual key management. You can also enable additional remote MCP tools (e.g., Browse, Crawl, Research, Code, and File Store) in Gemini CLI extensions if your client supports them. Use the provided CLI commands (npx atxp@latest) to interact with the server, or integrate ATXP into other MCP clients by pointing them at the same command line invocation. Examples include checking balance, funding, listing transactions, or performing dedicated actions like sending an SMS, performing a web search, or running code inside a sandbox.

Prerequisites:

• Node.js and npm (to use npx) or an environment that supports the MCP protocol via npx
• Optional: Gemini CLI if you plan to use the Gemini extension workflow

Install steps:

1. Ensure you have Node.js and npm installed. You can verify with:
   • node -v
   • npm -v
2. Install or run ATXP directly via npx (no global install required):
   • npx atxp@latest
3. If using Gemini CLI as an extension, install the extension and then start a Gemini session so the ATXP tools load:
   • gemini extensions install https://github.com/atxp-dev/atxp
   • After installing, start a new Gemini CLI session for the extension tools to load
4. Optionally, configure Claude Desktop / Cursor / Windsurf clients by adding ATXP to your MCP client config, for example: { "mcpServers": { "atxp": { "command": "npx", "args": ["-y", "atxp@latest"] } } }
5. To run ATXP directly with an existing account, you can provide your connection string via environment variable and run: ATXP_CONNECTION="<connection_string>" npx atxp@latest where the connection string can be obtained from your ATXP account flow.
6. Start using ATXP by invoking the CLI helpers, for example:
   • npx atxp@latest balance
   • npx atxp@latest fund
   • npx atxp@latest whoami

Notes and tips:

• ATXP uses a pay-per-use model with billing in USDC. Costs vary by tool and action (e.g., web search, image generation, email, SMS, voice calls).
• If you are onboarding a new agent, you can use the self-registration flow to create an account and receive initial tokens and an email address automatically.
• You can operate ATXP with either a newly registered account or an existing ATXP account by setting the ATXP_CONNECTION environment variable or passing the connection string directly.
• The MCP server runs over stdio; point any MCP-compatible client at the command provided (npx atxp@latest). In environments that support npx, this is the simplest integration path.
• For Gemini CLI users, the extension workflow requires loading the extension first, then starting a new session so tools load correctly.
• If you plan to use remote MCP tools (Browse, Crawl, Research, Code, File Store, etc.), enabling Gemini CLI extensions may be necessary and can require additional configuration on the client side.