xdcai 0.1.13

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 XDC AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# xdcai
+
+Pay for [x402](https://x402.org) services on the **XDC** network with USDC, from a
+custodial wallet — the agent **never pays gas** (EIP-3009).
+
+```bash
+npx xdcai login            # email -> OTP -> an XDC wallet
+npx xdcai wallet balance   # fund the printed address with USDC
+npx xdcai marketplace list --search lending,rates  # find the most relevant x402 services (ranked)
+npx xdcai call <x402-url>  # auto-pays the 402 and returns the result
+```
+
+See https://xdctaskman-web.vercel.app/integrate. MIT licensed.

package/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: xdcai
+description: Pay for x402 services on the XDC network with USDC. Log in with email, get a custodial XDC wallet, browse the curated marketplace, and call any x402 URL - the payment is signed from your wallet and you never pay gas (EIP-3009).
+---
+
+# XDC AI skill
+
+Use this skill to discover and pay for x402-protected services on XDC. Drive it through the `xdcai` CLI (installed via `npx xdcai` or `pnpm cli --`).
+
+## When to use
+- The user wants onchain data or any paid API that returns HTTP 402 on XDC.
+- The user asks to log in, check a wallet balance, list marketplace services, or call a paid URL.
+
+## Environments (important)
+This skill is a **CLI** - it needs a shell and outbound network. That means:
+- ✅ **Claude Code, Cursor, Codex, a terminal** - `npx xdcai ...` works directly.
+- ❌ **claude.ai web** - its sandbox blocks outbound network, so `login` can't reach the
+  auth/wallet service. In claude.ai, **add the MCP connector instead**:
+  `https://xdctaskman-x402-server.vercel.app/mcp` (Settings → Connectors → Add custom
+  connector). It exposes the same flow as tools (`login_start`, `login_verify`,
+  `wallet_address`, `wallet_balance`, `marketplace_list`, `call`, `wallet_transfer`) and runs
+  the network work server-side.
+
+## Setup (once)
+```
+npx xdcai login            # email → OTP → an XDC wallet is created for you
+npx xdcai wallet address   # show the address to fund with USDC
+npx xdcai wallet balance   # check USDC + XDC balance
+```
+
+## Core loop
+```
+npx xdcai marketplace list --search weather,forecast   # find the best-matching services
+npx xdcai call https://provider.example/x402/endpoint
+```
+Pass `--search` comma-separated keywords from the task; results are ranked by tags
++ capability (best match first) against the **live** catalog - the fastest way to
+find the most relevant API for a prompt.
+`call` performs the full x402 flow automatically: it requests the URL, and if it
+returns `402`, signs an EIP-3009 USDC payment authorization from your wallet,
+resends with the `X-PAYMENT` header, and returns the result. **You never pay gas**
+- a relayer settles the signed authorization on-chain.
+
+## Commands
+- `login [--email <e>] [--code <c>] [--accept-terms]` - authenticate; creates/loads your XDC wallet. Login requires accepting the Terms & Conditions (https://xdctaskman-web.vercel.app/terms): show them to the user and pass `--accept-terms` (non-interactive) only with the user's consent, or answer the interactive prompt.
+- `whoami` / `logout`
+- `wallet address|balance|fund`
+- `marketplace list [--search <a,b,c>] [--capability <c>] [--max-price <usdc>]` - `--search` ranks live services by tags + capability (OR over the terms, best first).
+- `call <serviceUrl> [--method GET|POST] [--data <json>]`
+
+## Output contract (for agents)
+- **stdout** = exactly one JSON object per command - parse this.
+  - `call` → `{ ok, status, paid, txHash?, explorer?, result }`
+  - `wallet transfer` → `{ success, amount, token, to, txHash?, explorer?, error? }`
+  - `login` → `{ loggedIn, email, address }`; `wallet address|balance|fund` → JSON; `whoami` → JSON
+  - On any failure → `{ "error": "<message>" }` and a non-zero exit code.
+- **stderr** = human/log lines (prompts, "Sent a code...", structured logs). Ignore for parsing.
+- Set `LOG_LEVEL=error` to silence info logs.
+
+## Notes
+- Amounts are in USDC (6 decimals). Prices are shown per call.
+- Always `wallet balance` before paid calls; if USDC is 0, tell the user to fund
+  the printed address (gas is sponsored - no native XDC needed).