# > DOCUMENTATION / API_MANUAL

ATTO_MARKET(1) API Commands

Atto Market exposes a small API marketplace surface for technical buyers and AI agents: discover products, search MCP-ready capabilities, request a quote, execute a paid API call, and read the resulting usage receipt.

## Quickstart

terminal // quote and execute 
$ export MARKET_API="http://localhost:8080"
$ curl -s "$MARKET_API/categories"
$ curl -s "$MARKET_API/capabilities/search?query=web%20search"

$ curl -s -X POST "$MARKET_API/quote" \
  -H "Content-Type: application/json" \
  -d '{"capabilityId":"search-web","customerId":"demo-buyer","requestedUnits":1}'

$ curl -s -X POST "$MARKET_API/execute/search-web" \
  -H "Content-Type: application/json" \
  -d '{"customerId":"demo-buyer","input":{"query":"MCP API marketplace"}}'

$ curl -s "$MARKET_API/receipts?customerId=demo-buyer"

## Marketplace Flow

The MVP flow is intentionally direct: catalog discovery, quote creation, gateway execution, and receipt monitoring. It is built for API resellers, AI agent developers, and MCP clients that need predictable paid calls.

01. Catalog Discovery

Use /categories, /products, and /capabilities/search to find web search APIs, page extraction tools, browser rendering, providers, prices, and MCP readiness.

02. Quote and Execute

POST /quote to reserve a max price, then POST /execute/{capabilityId} with input payload to run the selected capability through the gateway.

03. Receipts and MCP

Read /receipts and /monitor/summary for usage records, or call /mcp/tools and /mcp/call when an agent needs the marketplace as an MCP broker.

// FAQ : Marketplace integration
Q: What can agents buy through Atto Market?
A: The first catalog focuses on API capabilities such as web search, page extraction, and browser rendering. Listings expose provider, price, execution mode, and MCP-ready metadata.
Q: What does a usage receipt contain?
A: A receipt records the customer, product, capability, provider, execution mode, quoted max price, settled price, currency, status, request summary, and response summary.

## Endpoints

GET /categories arrow_forward GET /products arrow_forward GET /capabilities/search arrow_forward POST /quote arrow_forward POST /execute/{capabilityId} arrow_forward GET /receipts arrow_forward GET /mcp/tools arrow_forward