npm — FAI MCP Server
Add AI Infra, Platform, and App Knowledge to Your Agent
npx frootai-mcpnpm i -g frootai-mcphttps://mcp.frootai.dev/mcpFederation Router — one connection, every Tier-1 area
FrootAI MCP v6 stops being one tool surface and becomes a federation router: one MCP connection that exposes every Tier-1 tool from every Tier-1 publisher, namespaced as <area>.<tool>, gated by a single trust manifest you control. Stdio for local-first, or hosted at mcp.frootai.dev for centrally-managed teams.
Enterprise-ready Every attach passes the MCP Trust Gate — 4 trust tiers, byte-identical 3-way mirror, no silent-attach path.
Federated MCP Areas — 21 first-party + verified-publisher servers
Each area is a published MCP server the federation router attaches on demand. Sourced from mcp-servers-seed.json; mirrored to /data/mcp-marketplace.json + /data/mcp-trust.json.
Federation Lifecycle Tools — the 6 fai_* primitives
These are NOT the in-process tools below — they orchestrate attach/detach of the 21 federated areas above. Wired in M2; expanded across M3-M9. Every agent / skill / play / plugin can call these directly via the MCP protocol. Browse the full 100-server registry at /mcp-tooling/marketplace.
Trust Manifest — 4 tiers, gated at attach
Every fai_attach_mcp passes through this gate. There is no bypass. Published at /data/mcp-trust.json; same shape across npm-mcp + python-mcp + web (M0.12 drift-protected).
Without FrootAI MCP
- Agent searches the internet — slow, noisy
- Burns 5,000+ tokens per architecture query
- May hallucinate design guidance
- Generic answers — no Azure patterns
With FrootAI MCP
- Queries curated 664KB knowledge base
- 90% less token burn
- Zero hallucination — grounded in verified docs
- Azure-specific best practices & patterns
Connect to Your Client
{"mcpServers":{"frootai":{"command":"npx","args":["frootai-mcp"]}}}{"servers":{"frootai":{"command":"npx","args":["frootai-mcp"]}}}Point to npx frootai-mcp{"mcpServers":{"frootai":{"command":"npx","args":["frootai-mcp"]}}}{"mcpServers":{"frootai":{"command":"npx","args":["frootai-mcp"]}}}Add MCP connector{"mcpServers":{"frootai":{"command":"npx","args":["frootai-mcp"]}}}Tools Agent Receives
Static + live + agent chain + ecosystem + FAI engine + scaffold + marketplace = full MCP toolkit
Live Tools (v2 — network-enabled)
Agent Chain Tools (Build → Review → Tune)
AI Ecosystem Tools (v3)
Developer Tools
FAI Engine — The UniFAIng Glue (FAI Protocol Runtime)
Scaffold & Create — Generate Production-Ready Plays
Workspace — Detect, Inspect, Recommend
Marketplace — npm for AI Primitives (77+ Plugins)
Orchard MCP Server — Harvest Pipeline Tools
8 tools that drive the harvest pipeline: discover repos, extract architecture facts, find exemplars, import + customize Solution Plays. Paid tools require an active subscription.
GitHub metadata + license + commit SHA — deterministic, no LLM
discover_repo({ url: "https://github.com/Azure/azure-search-openai-demo" })Response shape ▸
{
"owner": "Azure",
"name": "azure-search-openai-demo",
"license": "MIT",
"commit_sha": "abc123def456",
"default_branch": "main",
"stars": 5200,
"language": "Python",
"topics": ["azure", "openai", "rag"]
}Shallow clone → RepoFacts JSON — architecture, services, languages
extract_facts({ url: "https://github.com/Azure/azure-search-openai-demo" })Response shape ▸
{
"services": ["Azure AI Search", "Azure OpenAI", "App Service"],
"languages": { "Python": 72, "Bicep": 18, "TypeScript": 10 },
"iac_tool": "bicep",
"has_docker": true,
"entry_points": ["app/backend/app.py"]
}Top-3 reference plays via embeddings for scaffold grounding
retrieve_exemplars({ query: "RAG with Azure AI Search" })Response shape ▸
[
{ "slug": "enterprise-rag", "similarity": 0.95 },
{ "slug": "contoso-chat", "similarity": 0.82 },
{ "slug": "aks-store-demo", "similarity": 0.71 }
]Browse all harvested Solution Plays with filter + sort
list_plays({ source: "harvested", sort: "confidence" })Response shape ▸
{
"total": 142,
"plays": [
{ "slug": "enterprise-rag", "confidence": 0.95, "source": "harvested" },
...
]
}Harvest → package → sign → deliver a Solution Play ZIP
import_accelerator({ url: "https://github.com/Azure/azure-search-openai-demo" })Response shape ▸
{
"run_id": "a1b2c3d4",
"status": "ready",
"zip_url": "https://cdn.frootai.dev/plays/...",
"manifest_url": "https://cdn.frootai.dev/plays/.../manifest.json",
"cosign_verify": "cosign verify-blob ..."
}Apply org policy defaults (regions, RBAC, naming) before import
customize_play({ slug: "enterprise-rag", regions: ["westeurope"] })Response shape ▸
{
"slug": "enterprise-rag",
"applied": { "regions": ["westeurope"], "naming": "contoso-{service}" },
"diff_url": "https://frootai.dev/.../customize/preview"
}Re-run the harvest pipeline on an existing play (freshness)
re_harvest({ slug: "enterprise-rag" })Response shape ▸
{
"run_id": "e5f6g7h8",
"status": "running",
"previous_sha": "abc123",
"new_sha": "def456"
}Founder-only: approve a harvested play for the public catalog
approve_play({ slug: "enterprise-rag", tier: "gold" })Response shape ▸
{
"slug": "enterprise-rag",
"approved": true,
"tier": "gold",
"published_at": "2026-06-14T12:00:00Z"
}Verified MCP Server — AVM Intelligence Tools
5 tools powered by Azure Verified Modules: browse the AVM catalog, validate WAF/CAF compliance, and compute cost + carbon footprint for composed infrastructure.
Query the AVM catalog with provider/type/tag filters
list_avm_modules({ provider: "Microsoft.Network" })Response shape ▸
{
"total": 47,
"modules": [
{ "name": "res/network/virtual-network", "version": "0.5.1", "provider": "Microsoft.Network" },
{ "name": "res/network/private-endpoint", "version": "0.3.0", "provider": "Microsoft.Network" },
...
]
}Fetch cached module content, docs, and version history
get_avm_module({ name: "res/network/virtual-network" })Response shape ▸
{
"name": "res/network/virtual-network",
"version": "0.5.1",
"description": "Azure Virtual Network with subnets, NSGs, and peering",
"docs_url": "https://github.com/Azure/bicep-registry-modules/...",
"versions": ["0.5.1", "0.4.0", "0.3.2"],
"parameters": ["name", "addressPrefixes", "subnets", "tags"]
}Validate composed Bicep/Terraform against WAF + CAF gates
validate_waf_compliance({ bicepPath: "infra/main.bicep" })Response shape ▸
{
"compliant": true,
"score": 92.5,
"pillars": {
"reliability": { "score": 95, "findings": [] },
"security": { "score": 88, "findings": ["Enable private endpoints"] },
"cost": { "score": 94, "findings": [] },
"operational": { "score": 93, "findings": [] },
"performance": { "score": 92, "findings": [] }
}
}Estimate monthly Azure cost for composed infrastructure
compute_cost({ slug: "enterprise-rag", region: "westeurope" })Response shape ▸
{
"slug": "enterprise-rag",
"region": "westeurope",
"monthly_eur": 147.50,
"band": "€100–200/mo",
"breakdown": [
{ "service": "Azure AI Search", "sku": "S1", "eur": 72.00 },
{ "service": "Azure OpenAI", "sku": "gpt-4o", "eur": 45.00 },
{ "service": "App Service", "sku": "P1v3", "eur": 30.50 }
],
"priced_at": "2026-06-14"
}Estimate g CO₂e/mo carbon footprint for composed infra
compute_carbon({ slug: "enterprise-rag", region: "westeurope" })Response shape ▸
{
"slug": "enterprise-rag",
"region": "westeurope",
"g_co2e_month": 1240,
"band": "Low",
"breakdown": [
{ "service": "Azure AI Search", "g_co2e": 520 },
{ "service": "Azure OpenAI", "g_co2e": 480 },
{ "service": "App Service", "g_co2e": 240 }
],
"methodology": "Azure Carbon Optimization API"
}Install Guide — All 3 MCP Servers
Add the main FAI MCP server + the Orchard harvest server + the Verified AVM server to your AI agent in one config.
Listed on MCP Registries
VS Code / GitHub Copilot.vscode/mcp.json
{
"servers": {
"frootai": { "command": "npx", "args": ["frootai-mcp"] },
"frootai-harvest": { "command": "npx", "args": ["frootai-mcp", "--server", "harvest"] },
"frootai-verified": { "command": "npx", "args": ["frootai-mcp", "--server", "verified"] }
}
}CursorSettings → MCP → Add Server
{
"mcpServers": {
"frootai": { "command": "npx", "args": ["frootai-mcp"] },
"frootai-harvest": { "command": "npx", "args": ["frootai-mcp", "--server", "harvest"] },
"frootai-verified": { "command": "npx", "args": ["frootai-mcp", "--server", "verified"] }
}
}Claude Desktopclaude_desktop_config.json
{
"mcpServers": {
"frootai": { "command": "npx", "args": ["frootai-mcp"] },
"frootai-harvest": { "command": "npx", "args": ["frootai-mcp", "--server", "harvest"] },
"frootai-verified": { "command": "npx", "args": ["frootai-mcp", "--server", "verified"] }
}
}Continue.dev~/.continue/config.json → mcpServers
{
"mcpServers": [
{ "name": "frootai", "command": "npx", "args": ["frootai-mcp"] },
{ "name": "frootai-harvest", "command": "npx", "args": ["frootai-mcp", "--server", "harvest"] },
{ "name": "frootai-verified", "command": "npx", "args": ["frootai-mcp", "--server", "verified"] }
]
}Zedsettings.json → language_servers → mcp
{
"language_servers": {
"mcp": {
"servers": {
"frootai": { "command": "npx", "args": ["frootai-mcp"] },
"frootai-harvest": { "command": "npx", "args": ["frootai-mcp", "--server", "harvest"] },
"frootai-verified": { "command": "npx", "args": ["frootai-mcp", "--server", "verified"] }
}
}
}
}See It In Action
Real conversations with the FAI MCP server — what you ask and what you get back
What Makes This Different
Other MCP servers wrap APIs. FrootAI MCP is a domain knowledge engine with a protocol that binds AI primitives together.
| Feature | GitHub MCP | Anthropic MCP | FAI MCP |
|---|---|---|---|
| Runtime engine | No | No | ✅ FAI Engine |
| Wires primitives | No | No | ✅ fai-manifest.json |
| Quality gates | No | No | ✅ Guardrails per play |
| Scaffolds projects | No | No | ✅ 24 files, auto-wired |
| Knowledge base | No | No | ✅ Modules, BM25 |
| Plugin marketplace | No | No | ✅ 77+ plugins |
| Progress tokens | No | No | ✅ Per-file progress |
| Tool annotations | Partial | No | ✅ All tools |