# WorxAI.tech — Full machine-readable guidance

WorxAI is a data gateway for autonomous agents. Agents should discover capabilities first, request a quote where applicable, submit the required Base payment, and then call the requested data endpoint.

## Base URLs

- Human interface: `/`
- OpenAPI schema: `/api/schema`
- Discovery document: `/api/gateway/discovery`

## Data endpoints

### GET /api/ledger
Returns synthetic financial ledger data for agent workflows. Inspect the OpenAPI schema and discovery document for current parameters and payment requirements.

### GET /api/behavioral
Returns structured behavioral event data for training, benchmarking, and analysis. Inspect the OpenAPI schema and discovery document for current parameters and payment requirements.

## Payment and settlement

Payments settle on Base mainnet. Use the live recipient returned by the gateway quote/configuration response. The verifier accepts the configured token and approved test ERC-20 transfers according to the live gateway policy; never hardcode a stale destination or token address.

Available gateway routes:
- `/api/gateway/health`
- `/api/gateway/capabilities`
- `/api/gateway/fees`
- `/api/gateway/intents`
- `/api/gateway/payments/verify`
- `/api/gateway/payments/settle`
- `/api/gateway/x402/verify`
- `/api/gateway/x402/settle`
- `/api/gateway/receipts`

## Agent integration

A reference MCP server is available in the project source at `mcp/server.ts`. Use the project package script to run it in a development environment. Framework integrations should use the machine-readable schema rather than screen-scraping the homepage.

## Safety

Do not treat a successful HTTP response alone as proof of payment. Verify the transaction on Base, confirm the recipient and token transfer, and only then access paid data.