Documentation
MCP tool reference

Start

OverviewQuickstartAuthenticationMaking callsDiscoveryMCPErrors & billingAPI schemaPay with x402

Guides

Web searchOneSearchOneFindOneScrapeResearchWeb scrapingGTM & leads

Data APIs

Public recordsReal estateSocial dataOn-chain & marketsCompliance & KYBOpen data

Execution APIs

BrowserLLMsMediaComputeFiles & storageEmailCommerce

vaaya / docs / reference

Discovery

Find a service by browsing the catalog, searching by keyword, or describing your task. The catalog and keyword search are free; the HTTP consult action costs 1¢.

The index and descriptors

EndpointWhat it returns
GET /api/runThe machine-readable index of every callable service and action.
GET /api/run/{service}/{action}One action’s descriptor: description, price, and params schema.
/openapi.jsonOpenAPI schemas for fixed-price paid actions. See the schema guide for coverage.
/catalogThe human-browsable catalog.

The catalog includes specialist endpoints for social data, compliance, blockchain data, and public datasets. vaaya/discover is a free keyword search over all of them. It returns everything you need to make the call.

curl -X POST https://vaaya.ai/api/run/vaaya/discover \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "tiktok user followers"}'

# → [{ "service": "...", "action": "...", "endpoint": "...",
#      "price_cents": 1, "required_params": [...] }, ...]

vaaya/consult: plain English in, exact calls out

vaaya/consult (1¢) turns a plain-English request into exact calls. Describe what you want and it returns the service, action, params, and a suggested max_cost_cents. It asks one short question if a required detail is missing, and it remembers the conversation across turns.

curl -X POST https://vaaya.ai/api/run/vaaya/consult \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intent": "find the verified email of the CEO of stripe"}'