AdvisorServerToolConfig | OpenRouter Python SDK | OpenRouter

The Python SDK and docs are currently in beta. Report issues on GitHub.

Configuration for one openrouter:advisor server tool entry.

Fields

Field	Type	Required	Description	Example
`forward_transcript`	Optional[bool]	➖	When true, the full parent conversation is forwarded to the advisor so it sees the same context the executor does (and the tool-call `prompt`, if given, is appended as a final user turn). When false or omitted, the advisor receives only the `prompt` the executor passes in the tool call.	false
`instructions`	Optional[str]	➖	System instructions for the advisor sub-agent. When omitted, the advisor responds with no system prompt of its own.	You are a senior staff engineer. Give a focused, decisive plan.
`max_completion_tokens`	Optional[int]	➖	Maximum number of output tokens (including reasoning) the advisor may produce. When omitted, the provider’s default applies.	2048
`max_tool_calls`	Optional[int]	➖	Maximum number of tool-calling steps the advisor sub-agent may take during its agentic loop. Capped at 25. Only relevant when the advisor is given tools.	5
`model`	Optional[str]	➖	Slug of the advisor model to consult (any OpenRouter model). When omitted, the executor can choose it via the tool call’s `model` argument; if neither is set, the model from the outer API request is used. The advisor tool itself cannot be the advisor model.	~anthropic/claude-opus-latest
`name`	Optional[str]	➖	Optional name for this advisor. The model sees one tool per named advisor (and one default for an unnamed entry). Names must be unique across advisor entries. Letters, digits, spaces, underscores, and dashes; trimmed; 1–64 chars.	reviewer
`reasoning`	Optional[components.AdvisorReasoning]	➖	Reasoning configuration forwarded to the advisor call. Use this to control reasoning effort and token budget for models that support extended thinking.	`{"effort": "high"}`
`stream`	Optional[bool]	➖	When true, the advisor’s advice streams incrementally as it is produced. In the Responses API this emits `response.output_text.delta` events targeting the advisor output item; the final `advice` field is still set on the completed item. Has no effect on the Chat Completions API (where the advice arrives only as the final tool result). When false or omitted, the advice arrives only as the final result.	false
`temperature`	Optional[float]	➖	Sampling temperature forwarded to the advisor call. When omitted, the provider’s default applies.	0.7
`tools`	List[components.AdvisorNestedTool]	➖	Tools the advisor sub-agent may use while forming its advice. The advisor runs as an agentic sub-agent over these tools, then returns its text. Must not include the advisor tool itself.