ask_voltai— asks the Voltai knowledge agent a question and returns the answer, cited sources, and achat_id.
Connection details
Use the API key issued for your Voltai organization. Keys with no scope restrictions can use MCP. A scoped key needs both the MCP and Chat API scopes, because
ask_voltai runs a chat query on your behalf.
Set X-Voltai-User-ID to a stable, non-secret identifier that is unique to the
person or client using this MCP connection. It keeps floating-seat accounting
and concurrent-request limits separate when multiple MCP users share one API
key. Do not put an email address or other personal information in this header.
The header is optional. Without it, ask_voltai calls use one fixed identity for
the API key, the same one the Chat Query API
uses when user_id is omitted. All such callers then count as one user and can
run only one request at a time; a concurrent call is rejected with
user_session_limit_exceeded. If a key serves many people without this header,
ask Voltai to allow concurrent requests on the key. The organization-wide
session limit still applies.
Cursor
Add Voltai to your project-level.cursor/mcp.json or your user-level MCP configuration:
VOLTAI_API_KEY and a unique, stable VOLTAI_MCP_USER_ID in the
environment that launches Cursor, then enable the server in Cursor Settings
→ Tools & MCP.
Claude Code
Microsoft Copilot Studio
Copilot Studio’s Add MCP server dialog can send only the API key header. Add the server URLhttps://api-prod.voltai.ai/mcp/, choose API key
authentication, and set the header name to X-API-KEY.
Without X-Voltai-User-ID, all users of this connection share one Voltai
identity and run one request at a time. See the caller identity notes under
Connection details.
Asking questions
The client normally chooses when to callask_voltai. You can also ask explicitly:
Use Voltai to find the maximum operating temperature for this component.The tool accepts:
query(required) — the question to answer.chat_id(optional) — a previous result’s ID to continue that conversation.reasoning_level(optional) —low,medium(default), orhigh.topic_names(optional) — knowledge topics to search.
final_answer, sources, chat_id, chat_url, and conversation_id.
Conversation and usage behavior
Pass a returnedchat_id into a later call to preserve context. Calls use the same organization permissions, license limits, throttling, and source access as POST /chat/query/.
The MCP server runs the Voltai knowledge agent behind the tool call. This provides the full agent behavior with a small integration surface; it does not expose Voltai’s internal tools individually.
The MCP option in this documentation site’s copy menu gives an assistant access to documentation content. The hosted URL above connects an assistant to your organization’s live Voltai knowledge agent.