How svuillaume/forticnapp-ai works
FortiCNAPP LQL Agent turns a natural-language security question into a schema-aware, validated and executed query, then returns a certainty-scored result. The documented workflow is driven by a Claude Code sub-agent using a read-only stdio MCP server; the server also provides policy-query search, local query memory and result tables. The agent definition and iteration logic were not sampled, so those links rely on README documentation; server-side tool and API links use the sampled server excerpt.
Main entry points: lql-agent.md LQL agent · server.py API client · render.py Result renderer
Components 16
Query authoring
- LQL agent
.claude/agents/lql-agent.md
MCP tools
- MCP server
lql_mcp/server.py - Policy search
lql_mcp/server.py - Datasource tools
lql_mcp/server.py - Query validation
lql_mcp/server.py - Query execution
lql_mcp/server.py - API client
lql_mcp/server.py - Token exchange
lql_mcp/server.py - Endpoint allowlist
lql_mcp/server.py
Local memory
- Cache search
lql_mcp/server.py - Cache save
lql_mcp/server.py - Local query cache
Result presentation
- Result renderer
lql_mcp/render.py
Other components
- Engineer
- Claude Code
- FortiCNAPP API
Connections 24
- Engineer → Claude Code: asks question
README.md - Claude Code → LQL agent: routes question
README.md - LQL agent → MCP server: uses tools
README.md - MCP server → Policy search: exposes
lql_mcp/server.py - MCP server → Datasource tools: exposes
lql_mcp/server.py - MCP server → Query validation: exposes
lql_mcp/server.py - MCP server → Query execution: exposes
lql_mcp/server.py - LQL agent → Datasource tools: checks schema
README.md - LQL agent → Query validation: validates drafts
README.md - LQL agent → Query execution: tests queries
README.md - Policy search → API client: requests policies
lql_mcp/server.py - Datasource tools → API client: requests schemas
lql_mcp/server.py - Query validation → API client: validates LQL
lql_mcp/server.py - Query execution → API client: runs LQL
lql_mcp/server.py - API client → Endpoint allowlist: checks endpoint
lql_mcp/server.py - API client → FortiCNAPP API: sends API requests
lql_mcp/server.py - API client → Token exchange: exchanges credentials
lql_mcp/server.py - Token exchange → FortiCNAPP API: requests token
lql_mcp/server.py - LQL agent → Cache search: looks up prior queries
README.md - LQL agent → Cache save: saves strong queries
README.md - Cache search → Local query cache: reads
README.md - Cache save → Local query cache: writes
README.md - MCP server → Result renderer: uses renderer
lql_mcp/server.py - LQL agent → Result renderer: renders results
README.md