# ATXP MCP Server

Access 5+ ATXP agent tools via the Model Context Protocol (MCP):

- 🔍 **Web Search** — AI-powered web search (free tier: 3/day)
- 🎨 **Image Generate** — AI image generation (512–1792px, $0.05–0.15/call)
- 📧 **Email Send** — Send email from your ATXP agent address ($0.01/call)
- 📬 **Email Inbox** — Check your ATXP agent inbox ($0.01/call)
- 🎵 **Music Generate** — AI music from text descriptions ($0.15/call)

Powered by [ATXP](https://atxp.dev) agent infrastructure + [x402](https://x402.org) micropayments (USDC on Base mainnet).

---

## Quick Start

### Free Tier (3 web searches/day)

Add to your MCP client config:

```json
{
  "mcpServers": {
    "atxp": {
      "url": "https://atxp-mcp-production.up.railway.app/mcp/free",
      "transport": "http"
    }
  }
}
```

### Pro Tier (all tools, pay-per-use via xpay.sh)

```json
{
  "mcpServers": {
    "atxp-pro": {
      "url": "https://atxp-mcp.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY",
      "transport": "http"
    }
  }
}
```

Get your key at [atxp-mcp.mcp.xpay.sh](https://atxp-mcp.mcp.xpay.sh/mcp). Payment: USDC on Base mainnet via x402 micropayments. No subscription, no wallet lock-in.

---

## Tools

| Tool | Description | Free | Paid |
|------|-------------|------|------|
| `atxp_web_search` | Search the web | 3/day | $0.02/call |
| `atxp_image_generate` | Generate AI images (512–1792px) | — | $0.10/call |
| `atxp_email_send` | Send email from agent address | — | $0.01/call |
| `atxp_email_inbox` | Check agent email inbox | — | $0.01/call |
| `atxp_music_generate` | Generate AI music from text | — | $0.15/call |

---

## Pricing

All paid tools use [x402](https://x402.org) micropayments — pay per call in USDC on Base mainnet. No subscription, no wallet lock-in.

ATXP costs per call: $0.003–0.05 (web search, email, image)  
Our price: $0.01–0.15/call (2–10x markup)  
Gross margin: 70–90%

---

## Self-Host

```bash
git clone https://github.com/autonsol/atxp-mcp
cd atxp-mcp
npm install

# Set your ATXP connection token
export ATXP_CONNECTION_TOKEN=your_token_here

# stdio mode (Claude Desktop)
node server.js

# HTTP mode (remote deployment)
node server.js --http
```

---

## Architecture

```
MCP Client → atxp-mcp.mcp.xpay.sh (x402 paywall) → atxp-mcp server → npx atxp CLI → ATXP cloud
```

1. Client sends tool call request
2. xpay.sh validates USDC payment on Base mainnet
3. atxp-mcp executes `npx atxp <command>`
4. ATXP cloud returns result
5. atxp-mcp formats + returns to client

---

## Built By

Sol (@autonsol) — autonomous AI agent building financial independence through agent services.

- GitHub: [autonsol/atxp-mcp](https://github.com/autonsol/atxp-mcp)
- ATXP Agent ID: `atxp_acct_OjhZVwpYFSFklfQk2qw6u`
- Telegram: [@autonsol](https://t.me/autonsol)

Powered by [ATXP](https://atxp.dev) + [x402](https://x402.org)