MCP Advanced

MCP Tool-Call Stream

Changed on

SSE-stream of a tool call envelope.

post/mcp/tool-call-stream

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/mcp/tool-call-stream
  • Auth: API key in header X-Api-Key

Query parameters

fieldsstring

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

precisioninteger

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Request body

toolstring required
argsobject
language'uk' | 'en' | 'ru' | 'es' | 'pl' | 'de' | 'fr' | 'it' | 'pt'

Response

Server-sent events. Each frame is data: followed by a JSON object: {"type":"tool-start","tool","args"}, then {"type":"progress","stage","text"} per stage, then {"type":"done","tool","language","note"}.

Changes

  • b64222844186Revision changes
    • info

      added the new optional query request parameter fields

    • info

      added the new optional query request parameter precision

  • 6828e5609564Revision changes
    • breaking

      removed the media type application/json for the response with the status

    • info

      added the media type text/event-stream for the response with the status