# XDC AI

> Agent-native commerce on the XDC Network. AI agents discover APIs in a curated marketplace and pay for them per call with USDC over the x402 protocol — gaslessly (EIP-3009). Two audiences: agents that pay for APIs, and providers that list APIs for USDC.

Key facts for agents:
- Pay for any listed API with USDC; the agent never holds native XDC (gas is sponsored via EIP-3009).
- In a terminal / Claude Code / Cursor / Codex: use the `xdcai` CLI (`npx xdcai ...`).
- In Claude.ai / ChatGPT web (sandboxed, no outbound network): add the MCP connector `https://api.xdcai.tech/mcp`.
- Always discover via the marketplace first, then pay for the best-matching service — do not guess URLs.
- USDC on XDC mainnet: 0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1 (6 decimals). Chain ID 50.

## For agents
- [Overview](https://docs.xdcai.tech/): what XDC AI is and how it works.
- [Quickstart](https://docs.xdcai.tech/quickstart): pay for your first API.
- [Claude.ai & ChatGPT (MCP)](https://docs.xdcai.tech/agents/claude-ai): add the connector `https://api.xdcai.tech/mcp`.
- [CLI](https://docs.xdcai.tech/agents/cli): `npx xdcai` login/wallet/marketplace/call.
- [Tools & commands](https://docs.xdcai.tech/agents/tools): full reference + JSON output contract.
- [Pay-per-call loop](https://docs.xdcai.tech/agents/pay-per-call): discover → pay → verify.

## For providers (list your API)
- [Overview](https://docs.xdcai.tech/providers/overview): list an HTTP API or MCP server for USDC.
- [Listing schema](https://docs.xdcai.tech/providers/listing-schema): the providers.json entry format.
- [Make an x402 endpoint](https://docs.xdcai.tech/providers/x402-endpoint): return 402, accept X-PAYMENT, settle gaslessly.
- [Pricing & payTo](https://docs.xdcai.tech/providers/pricing-payto): per-call price and settlement address.
- [Submit your listing](https://docs.xdcai.tech/providers/submit): review and ingestion.
- [Security requirements](https://docs.xdcai.tech/providers/security): TLS, trustworthy content, safe settlement.

## Reference
- [x402 flow](https://docs.xdcai.tech/reference/x402-flow): 402 challenge → X-PAYMENT → relayer settlement.
- [Wallet & gasless](https://docs.xdcai.tech/reference/wallet-gasless): the wallet model and why no gas is needed.
- [Constants](https://docs.xdcai.tech/reference/constants): chain IDs, USDC address/decimals, endpoints.
- [Marketplace API](https://docs.xdcai.tech/reference/marketplace-api): discovery and the service object shape.
- [Errors & troubleshooting](https://docs.xdcai.tech/reference/errors): 402 is expected; common fixes.

## Manifests
- [skill.json](https://docs.xdcai.tech/skill.json): machine-readable agent skill/tool manifest.
- [SKILL.md](https://docs.xdcai.tech/SKILL.md): agent skill instructions.