Microsoft Foundry (Azure AI Foundry) + Neo4j Integration

Microsoft Foundry is a unified platform for building, deploying, and operating enterprise AI agents and applications. Neo4j is the graph database and knowledge layer that grounds those agents in connected enterprise data — relationships, hierarchies, and multi-hop paths the model can actually reason over.

Why Graph

Most enterprise research questions are relationship questions: which companies compete in this industry, who runs them, what does the news say, where do they operate, and how are any two of them connected. Vector search and document retrieval flatten those connections; a graph keeps them. Neo4j gives Foundry agents a tool that follows relationships, traverses hierarchies, and returns shaped results — bounded by Cypher, not by token budget.

Architecture

flowchart LR
    user["User"] --> agent["Foundry agent<br/>(model + tools)"]
    agent -->|MCP| mcp["Neo4j MCP server<br/>Azure Container Apps"]
    agent -->|function tools| sdk["Your app /<br/>tool executor"]
    mcp --> neo4j[("Neo4j Aura<br/>or self-managed")]
    sdk --> neo4j

The MCP path is shared infrastructure: deploy once, attach from Foundry, Copilot Studio, Microsoft Agent Framework, or any MCP client. The function-tool path keeps Neo4j access inside your application boundary when you need tighter control over Cypher, secrets, and audit.

Quick Start

az login
cd microsoft-foundry/infra
./deploy.sh                    # answer "Y" at the Foundry provisioning prompt
./test-mcp.sh "$(azd env get-value mcpEndpoint)"

Defaults connect to the public companies Neo4j demo graph and provision a Microsoft Foundry account, project, gpt-4o-mini model deployment, and an Azure AI Developer role assignment for you. deploy.sh writes a shared microsoft-foundry/.env that every example sources.

Full deploy guide and configuration knobs: infra/README.md. BYO-Foundry/BYO-Neo4j env schema: .env.example.

Integration Paths

Path When to use Folder

MCP

Reusable Neo4j MCP for one or many Foundry agents.

examples/mcp

Foundry SDK

Your app runs with more control over tools and Cypher queries

examples/foundry-sdk

References

Microsoft Foundry

Neo4j