# XDC Taskman

> Payment rails for AI agents. XDC Taskman gives any LLM agent a custodial XDC
> wallet and lets it pay for x402 APIs per call in USDC — gasless (EIP-3009),
> no seed phrase, no credit card. Built on the open x402 standard (exact-evm),
> settled on XDC mainnet (USDC, Circle FiatTokenV2).

## How an agent uses it
1. `npx xdc-taskman login --email <email>` → creates/loads a custodial XDC wallet (deterministic per email).
2. `npx xdc-taskman wallet address` → print the address; fund it with USDC.
3. `npx xdc-taskman marketplace list [--search <a,b,c>]` → discover curated x402 services on the live catalog; `--search` ranks by tags + capability (comma-separated terms, best match first) to find the most relevant API for a task. Also filters by `--capability`/`--max-price`.
4. `npx xdc-taskman call <serviceUrl>` → on HTTP 402 it signs an EIP-3009 USDC authorization and returns the result. The agent never pays gas; a relayer settles on-chain.

Output contract: each command prints exactly one JSON object to stdout. `call` → `{ ok, status, paid, txHash?, explorer?, result }`. Errors → `{ "error": "<message>" }` with a non-zero exit. Logs/prompts go to stderr. Set `LOG_LEVEL=error` to silence logs.

## Docs
- [Agent setup guide](https://xdctaskman-web.vercel.app/setup.md): paste-and-go instructions for an agent.
- [SKILL.md](https://xdctaskman-web.vercel.app/SKILL.md): the skill manifest (when to use + commands + output contract).
- [skill.json](https://xdctaskman-web.vercel.app/skill.json): machine-readable tool/command definitions.
- [Integration page](https://xdctaskman-web.vercel.app/integrate): human + agent walkthrough.
- [Marketplace](https://xdctaskman-web.vercel.app/marketplace): curated x402 services with live payTo addresses.
- [List your API](https://xdctaskman-web.vercel.app/providers): how providers monetize an API per call.

## Integrations
- CLI on npm: `xdc-taskman` (run with `npx xdc-taskman`). Needs a shell + network — works in Claude Code, Cursor, Codex, a terminal. Does NOT work in claude.ai web (sandboxed network); use the MCP connector there.
- MCP server (Streamable HTTP): https://xdctaskman-x402-server.vercel.app/mcp — discovery tools (get_service_info, list_resources, inspect_resource) PLUS full agent tools (login_start, login_verify, wallet_address, wallet_balance, marketplace_list, call, wallet_transfer). Add as a custom connector in claude.ai; the network work runs server-side.
- Claude skill bundle: https://xdctaskman-web.vercel.app/xdc-taskman-skill.zip (SKILL.md + skill.json).

## Constants
- XDC mainnet chainId 50. USDC (XDC) 0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1, 6 decimals.
- Payment scheme: x402 exact-evm; settlement: EIP-3009 transferWithAuthorization (gasless for the caller).