1# Tool — Fabric IQ (preview)
2 
3Connect an agent to Microsoft Fabric data — Ontology, Fabric data agents, and Power BI semantic models — through **Fabric IQ**. The agent delegates natural-language questions; Fabric IQ runs them against the enterprise ontology (NL2Ontology) and returns synthesized answers under the signed-in user's Fabric permissions.
4 
5## Toolbox shape
6 
7```json
8{
9  "type": "fabric_iq_preview",
10  "project_connection_id": "<fabriciq-connection-name>",
11  "server_label": "<short-lowercase-label>",
12  "server_url": "https://<host>/v1/mcp/..."
13}
14```
15 
16## `server_url` by Fabric item type
17 
18| Fabric item | `server_url` pattern | Supported auth |
19|---|---|---|
20| Ontology | `https://{host}/v1/mcp/dataPlane/workspaces/{workspaceId}/items/{itemId}/ontologyEndpoint` | BYO Entra app only |
21| Fabric data agent | `https://{host}/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent` | BYO Entra app *or* managed OAuth |
22| Power BI semantic model | `https://{host}/v1/mcp/fabricaihub/integrations/m365` | BYO Entra app *or* managed OAuth |
23 
24## Requirements
25 
26- Microsoft Fabric license for both the developer and every calling end-user.
27- For Ontology / Power BI: Entra app with delegated Power BI permissions `Item.Execute.All` + `Item.Read.All`; tenant admin consent required. For Data Agent: `DataAgent.Execute.All`.
28- Each Fabric item must be **published** before it can be consumed through Fabric IQ.
29- VNet integration is **not** supported.
30- Tip: for Power BI semantic models, use latest models — measure/hierarchy reasoning benefits significantly.
31 
32## References
33 
34For the full Entra app setup, connection-creation walkthrough, and troubleshooting, see [Fabric IQ tool documentation](https://learn.microsoft.com/azure/foundry/agents/how-to/tools/fabric-iq).
35 
36- [agent-tools.md](agent-tools.md) — tool index
37- [foundry-tool-catalog.md](foundry-tool-catalog.md) — connection shape for Fabric IQ
38