Skip to main content

​
Agent Tools

The nao agent uses built-in tools autonomously to answer user requests.
Execute SQL against connected databases and return structured results.
  • Supports multiple database connections.
  • Returns typed columns and row counts.
  • Outputs can be reused by other tools.
Create charts from SQL results.Supported chart types:
  • Bar charts
  • Line charts
  • Pie charts
Charts are rendered in chat and can also be sent in Slack conversations.
List files and directories so the agent can navigate project structure.
Read context files such as SQL models, docs, and rule files.
Search text patterns across context files with regex.
You do not need to select tools manually. The agent chooses and orchestrates tools based on each question.

​
MCPs

MCP (Model Context Protocol) servers expose external tools that the agent can call next to built-in tools. Configure MCP servers in agent/mcps/mcp.json: 
{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["-y", "@getnao/metabase-mcp-server@latest"],
      "env": {
        "METABASE_URL": "http://localhost:3008/",
        "METABASE_API_KEY": "your-metabase-api-key"
      },
      "disabled": false,
      "autoApprove": [],
      "disabledTools": []
    }
  }
}
Do not commit secrets. Store credentials in runtime environment variables or a secrets manager.
Admins can manage MCP server enablement from Admin Setup.

​
Skills

Skills are reusable workflows defined as markdown files in agent/skills/. A file is recognized as a skill only if:
  1. It is stored in agent/skills/.
  2. It starts with YAML frontmatter including name and description.
---
name: top-customers
description: Analyze database to find top 5 customers by total payments.
---
In chat, users can trigger skills through / shortcuts or natural prompts that match skill descriptions.