MCP Server
Nagi can operate as a Model Context Protocol (MCP) server. This enables AI agents to check Nagi's data state and execute convergence operations.
Tools
When started with nagi mcp, the following tools are exposed to MCP clients.
| MCP tool | Corresponding CLI | Permission | --allow-sync |
|---|---|---|---|
nagi_status |
nagi status |
Read-only | Not required |
nagi_evaluate |
nagi evaluate |
Read-only | Not required |
nagi_sync |
nagi sync |
Write | Required |
Tip
By default, only read-only tools (nagi_status, nagi_evaluate) are exposed. Specifying --allow-sync also exposes nagi_sync.
Setup
bash
nagi mcp # read-only
nagi mcp --allow-sync # also allow sync
The MCP server communicates via stdio. Connect from Claude Desktop or other MCP clients.
Use Cases
AI agents can use Nagi for the following use cases:
- Query data state in natural language ("Is daily-sales up to date?")
- Detect Drifted Assets and analyze the cause
- Execute sync after a user approval process and verify the result
- Investigate Assets stopped by Guardrails and suggest next actions