---
title: "Ask Mana product context"
method: POST
path: "/nlweb/ask"
tags: ["agents"]
---

# Ask Mana product context

`POST /nlweb/ask`

## Request

- Base URL: `https://mana.am`
- URL: `https://mana.am/nlweb/ask`
- Auth: none required

NLWeb-style endpoint for agent discovery. Returns product, pricing, API, auth, and MCP guidance as JSON, or SSE when prefer.streaming is true.

## Headers

- `Mana-API-Version` string
- `Idempotency-Key` string

## Request body

- AskRequest
  - `query` union
    - string: Natural-language question about Mana.
    - object
      - `text` string, required: NLWeb-style natural-language query text.
      - `site` string: Optional NLWeb site/domain hint.
  - `question` string: Alias for query.
  - `prefer` object
    - `streaming` boolean: When true, return text/event-stream.
  - `streaming` boolean: Set true to request SSE streaming.
  - `stream` boolean: Alias for streaming.

## Response `200`

Answer with citations and metadata.

- AskResponse
  - `_meta` object, required
    - `response_type` 'answer' | 'endpoint' | 'job', required
    - `response_format` string: NLWeb response format, usually conversational_search.
    - `version` string, required: NLWeb-compatible response version.
    - `source` string
  - `query` string
  - `answer` string, required
  - `results` object[], required

## Other responses

- `429`: Rate limit exceeded. Public reads allow 120 requests per 60 seconds; agent discovery and MCP probes allow 60 requests per 60 seconds. Retry after the provided Retry-After or RateLimit-Reset window.
- `500`: Unexpected server error. Retry later or check status documentation before repeating automated requests.

---

[API](https://skmtc.dev/mana/apis/mana-public-read-api.md) · [All operations](https://skmtc.dev/mana/apis/mana-public-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mana/apis/mana-public-read-api/revisions/aa8cbea94bc5?raw)