Skip to main content
The Orion MCP server exposes 20 tools organized into read-only and action categories. Each tool includes annotations so your AI assistant knows which tools are safe to call without confirmation.

​
Action Tools

These tools create, modify, or trigger operations in Orion.

​
ask_orion

Send a natural language question to Orion and get an AI-powered data analysis response. This is the primary tool for interacting with Orion.
Orion performs multi-step analyses that take 1-2 minutes. After calling ask_orion, use get_conversation_history to poll for the final response. Wait at least 30 seconds between polls.

​
create_conversation

Start a new Orion conversation.

​
execute_metric

Trigger execution of a metric to refresh its current value.

​
run_workflow

Trigger execution of a workflow (insight maker).

​
delete_artifact

Delete a slide deck, dashboard, or report artifact. This is a destructive action.

​
Read-Only Tools

These tools only read data and are safe to call without confirmation.

​
list_projects

List Orion projects the user has access to.

​
list_users

List all users in the Orion organization. Returns user ID, name, and role.

​
list_conversations

List chat conversations for a user.

​
get_conversation_history

Read messages from an existing Orion conversation. Use this to poll for results after calling ask_orion.

​
list_metrics

List metrics (KPIs) for a project.

​
get_metric

Get full metric detail including definition, Python code, data sources, and latest result.

​
get_metric_results

Get historical execution results for a metric.

​
get_metric_insights

Get auto-detected metric insights showing significant changes and anomalies for a project.

​
list_workflows

List workflows (insight makers) for a project.

​
get_workflow

Get workflow detail including notebook data, sources, and metric references.

​
get_workflow_results

Get execution results for a workflow.

​
list_artifacts

List slide decks, dashboards, or reports for a project.

​
get_artifact

Get the content of a slide deck, dashboard, or report as markdown.

​
search_wiki

Search the Orion wiki/knowledge base.

​
list_recommendations

Get AI-generated recommendations for a project with suggested analysis prompts.