asrai-x402

# Asrai — Crypto Analysis via x402

## Install

```bash
npx -y -p asrai-mcp install-skill
```

Auto-detects OpenClaw, Cursor, Cline, and other agents. Then set your key:

```
ASRAI_PRIVATE_KEY=0x<your_private_key>  # add to ~/.env
```

For MCP agents (Cursor, Cline, Claude Desktop) also add to config:

```json
{
  "mcpServers": {
    "asrai": { "command": "npx", "args": ["-y", "asrai-mcp"] }
  }
}
```

---

Use Asrai tools when the user asks about crypto prices, market analysis, trading signals, sentiment, or investment advice.

## When to use

- Crypto price / chart / technical analysis → use asrai tools
- Market sentiment, CBBI, fear/greed → use asrai tools
- "What should I buy?" / portfolio advice → use `portfolio` tool
- Elliott Wave, smart money, order blocks → use asrai tools
- DEX data, low-cap tokens → use asrai tools
- General knowledge you already know well → answer directly (costs $0.005 per call)

## How to call

### If asrai MCP tools are available (Cursor, Cline, Claude Desktop)

Call the appropriate MCP tool directly:
```
technical_analysis(symbol, timeframe)
sentiment()
forecast(symbol)
market_overview()
ask_ai(question)
...
```

### If no MCP tool — use bash (OpenClaw and other agents)

Use the same tool names via bash:
```bash
npx -y -p asrai-mcp asrai <tool> [args...]
```

Examples:
```bash
npx -y -p asrai-mcp asrai ask_ai "What is the outlook for BTC today?"
npx -y -p asrai-mcp asrai technical_analysis BTC 4h
npx -y -p asrai-mcp asrai sentiment
npx -y -p asrai-mcp asrai forecast ETH
npx -y -p asrai-mcp asrai market_overview
npx -y -p asrai-mcp asrai coin_info SOL
npx -y -p asrai-mcp asrai portfolio
npx -y -p asrai-mcp asrai indicator_guide ALSAT
```

Requires `ASRAI_PRIVATE_KEY` set in `~/.env` or environment. Payment is signed automatically.

## MCP tools

| Tool | What it does | Cost |
|---|---|---|
| `market_overview` | Full brief: trending, gainers/losers, RSI, screeners, sentiment, cashflow — use for complete reports only | $0.095 (19 calls)...

# Asrai — Crypto Analysis Skill

Crypto market analysis skill for AI agents. Powered by [Asrai](https://asrai.me) via x402 — pay $0.005 USDC per call, no subscription needed.

Works with **OpenClaw**, **Claude Desktop**, **Cursor**, **Cline**, and any MCP-compatible or bash-capable agent.

---

## Install

### One command — works everywhere

```bash
npx -y -p asrai-mcp install-skill
```

Auto-detects OpenClaw, Cursor, Cline, and other agents. Copies SKILL.md to the right place. Then restart your agent or run "refresh skills".

### Manual — OpenClaw (if auto-detect fails)

```bash
git clone https://github.com/abuzerasr/asrai-skill.git ~/.openclaw/workspace/skills/asrai
```

Then restart OpenClaw or run "refresh skills".

### Manual — Cursor / Cline / other agents

```bash
npx skills add abuzerasr/asrai-skill
```

Or via [ClawHub](https://clawhub.ai/abuzerasr/asrai-x402) — one-click install.

---

## Setup

### 1. Set your private key

```bash
echo "ASRAI_PRIVATE_KEY=0x<your_private_key>" >> ~/.env
```

Your wallet must hold USDC on Base mainnet (~$1–2 is plenty).

### 2. Connect the MCP server (Cursor, Cline, Claude Desktop)

Add to your MCP config:

```json
{
  "mcpServers": {
    "asrai": {
      "command": "npx",
      "args": ["-y", "asrai-mcp"]
    }
  }
}
```

Config file locations:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

> **OpenClaw users:** skip this step — OpenClaw uses bash automatically, no MCP config needed.

### 3. n8n / remote connections

```
HTTP Streamable: https://mcp.asrai.me/mcp?key=0x<your_private_key>
SSE (legacy):    https://mcp.asrai.me/sse?key=0x<your_private_key>
```

---

## How to use

Just ask your agent naturally — it picks the right tool automatically:

> "Do a technical analysis on BTC 4h"
> "What's the market sentiment right now?"
> "Give me a price forecast for ETH"
> "Show me the top ga...