Skip to main content
Asking through MCP is an asynchronous conversation flow: your AI client connected to WisdomAI starts a chat, checks for the result, and continues when WisdomAI needs clarification or a follow-up. This guide walks through the tool sequence and response states for anyone building directly against the MCP server.
When using WisdomAI through an AI client, just describe the question or task. Your AI client automatically selects and calls the appropriate MCP tools, so you don’t need to know or remember the tool names. The details below are mainly useful for building an AI agent or integrating directly with the MCP server.

​
Domain scope

Questions run against a domain. WisdomAI determines which domain a question belongs to from the question itself, so domainId is optional when you start a conversation. Pass it when you want to query a specific domain. Tools are available to list the domains you can access, along with a domain’s tables and entities and the documented descriptions of its tables and columns.

​
The flow

The diagram below shows how a question moves from a new conversation through polling, clarification, completion, and follow-up. A question starts with new_chat, then get_chat_result is polled until the status is terminal. running returns to polling; needs_clarification is answered with send_message and polling resumes; cancelled, completed, and failed end the turn. A completed answer can be followed up with send_message, which returns to polling. A question starts with new_chat, then get_chat_result is polled until the status is terminal. running returns to polling; needs_clarification is answered with send_message and polling resumes; cancelled, completed, and failed end the turn. A completed answer can be followed up with send_message, which returns to polling.

​
Ask a question

​
Step 1: Start a conversation

new_chat opens a conversation and asks the first question. The result carries a conversationId and a status. Use that conversationId for every later call in the conversation.

​
Step 2: Check for the result

Answers are generated asynchronously. Call get_chat_result until the status is terminal.

​
Step 3: Respond if clarification is needed

When WisdomAI needs more information to answer, it returns the needs_clarification status rather than guessing. The result carries the question and the available choices. Send the answer with send_message on the same conversation, then continue checking for the result.

​
Step 4: Continue the conversation

send_message adds a follow-up to an existing conversation, which keeps the context of everything asked before it. A question unrelated to the conversation, or about a different domain, belongs in a new conversation.

​
Cancel a response

cancel_chat requests cancellation of the response currently being generated. It takes a conversationId. If nothing is running, no action is taken.

​
What comes back

A completed answer contains one or more content items: The Highcharts configuration contains the underlying data and can be passed to Highcharts to render the visualization yourself.

​
Next steps

Give feedback

Rate an answer or ask a domain admin for help.

Manage context

Read and edit the definitions that shape answers.