
FrootAI
MCP Server (Python)
From the Roots to the Fruits. Itβs simply Frootful.
An open ecosystem where Infra, Platform, and App teams build AI β Frootfully.
A uniFAIng glue for the GenAI ecosystem, enabling deterministic and reliable AI solutions.
The Philosophy Behind FrootAI β The Essence of the FAI Engine
FrootAI is an intelligent way of packaging skills, knowledge, and the essential components of the GenAI ecosystem β all synced, not standalone. Infrastructure, platform, and application layers are woven together so that every piece understands and builds on the others. Thatβs what βfrom the roots to the fruitsβ means: a fully connected ecosystem where Infra, Platform, and App teams build AI β Frootfully.
The FROOT Framework
FROOT = Foundations Β· Reasoning Β· Orchestration Β· Operations Β· Transformation
| Layer | What You Learn |
|---|---|
| F | Tokens, models, glossary, Agentic OS |
| R | Prompts, RAG, grounding, deterministic AI |
| O | Semantic Kernel, agents, MCP, tools |
| O | Azure AI Foundry, GPU infra, Copilot ecosystem |
| T | Fine-tuning, responsible AI, production patterns |
The FAI Ecosystem

Quick Start
Requirements: Python >= 3.10
pip install frootai-mcpRun as MCP Server
frootai-mcp-pyUse in Python
from frootai_mcp.server import mcp
# Run as MCP server (stdio transport)
mcp.run(transport="stdio")Or call tools directly:
import asyncio
from frootai_mcp.server import search_knowledge, wire_play
result = asyncio.run(search_knowledge(query="RAG architecture"))
print(result)Connect to Your Agent
VS Code / GitHub Copilot .vscode/mcp.json:
{
"servers": {
"frootai": {
"type": "stdio",
"command": "frootai-mcp-py"
}
}
}Claude Desktop / Cursor
{
"mcpServers": {
"frootai": {
"command": "frootai-mcp-py"
}
}
}MCP Capabilities
| Capability | Count | Description |
|---|---|---|
| Tools | 45 | Full MCP tools with annotations |
| Resources | 4 | URI templates for modules, plays, glossary, overview |
| Prompts | 6 | Guided workflows for architecture, review, scaffold |
| Search | BM25 | 358 docs Γ 8,627 terms, Robertson IDF |
| Plays | 100 | Solution architectures from starter to enterprise |
| Primitives | Growing | Agents, instructions, skills, hooks, plugins |
MCP Tools (45)
Knowledge (6) β bundled knowledge, works offline
list_modulesβ browse FROOT knowledge modules by layerget_moduleβ read any module in fulllookup_termβ AI/ML glossary lookup (comprehensive glossary)search_knowledgeβ BM25 full-text search across all modulesget_architecture_patternβ architecture decision guidesget_froot_overviewβ complete framework summary
Solution Plays (5) β 100 pre-architected solutions
list_solution_playsβ list all 100 plays with filtersget_play_detailβ full play info with infra, tuning, complexitysemantic_search_playsβ BM25-powered play matchingcompare_playsβ side-by-side play comparisongenerate_architecture_diagramβ Mermaid.js diagrams
Agent Chain (3) β build β review β tune
agent_buildβ architecture guidance + recommended playagent_reviewβ security, quality, compliance auditagent_tuneβ production readiness + tuning recommendations
Azure / Live (4) β Azure AI intelligence
get_model_catalogβ model catalog with pricing tiersget_azure_pricingβ service pricing by tiercompare_modelsβ side-by-side model comparisonestimate_costβ itemized monthly cost per play
Ecosystem (5) β platform awareness
get_github_agentic_osβ .github Agentic OS guidelist_community_playsβ community plugin marketplacefetch_azure_docsβ Azure documentation linksfetch_external_mcpβ discover MCP serversget_play_specβ SpecKit with WAF alignment
FAI Engine (5) β protocol wiring
wire_playβ generate fai-manifest.json for a playinspect_wiringβ check what primitives are connectedvalidate_manifestβ validate fai-manifest.json schemavalidate_configβ validate AI config parametersevaluate_qualityβ run quality evaluation (groundedness, relevance, etc.)
Marketplace (4) β primitive discovery
list_marketplaceβ browse AI primitives by typeget_primitive_detailβ get detail for a specific primitivesearch_marketplaceβ keyword search across all primitivesembedding_playgroundβ text similarity comparison (educational)
Scaffold (5) β project bootstrapping
scaffold_playβ scaffold a new play with DevKit structuresmart_scaffoldβ describe what you want, get the best playlist_templatesβ available scaffold templates by complexitypreview_scaffoldβ dry-run preview of scaffold outputscaffold_statusβ check scaffold completeness
Extra (8) β specialized utilities
run_evaluationβ run evaluation with custom thresholdsget_bicep_best_practicesβ Bicep IaC best practiceslist_primitivesβ list primitives by typeget_waf_guidanceβ WAF pillar guidancecheck_play_compatibilityβ check if plays can composeget_learning_pathβ curated learning paths by topicexport_play_configβ export play config as JSONget_version_infoβ server version and capabilities
MCP Resources (4)
| URI | Description |
|---|---|
fai://modules/{module_id} | Read FROOT module without tool call |
fai://plays/{play_id} | Read solution play without tool call |
fai://glossary/{term} | Look up glossary term without tool call |
fai://overview | Platform overview without tool call |
MCP Prompts (6)
| Prompt | Description |
|---|---|
design_architecture | Guided AI architecture design |
review_config | Structured config review for production |
pick_solution_play | Conversational play selection |
estimate_costs | Azure cost estimation workflow |
scaffold_project | Project bootstrapping workflow |
learn_fai_protocol | FAI Protocol educational walkthrough |
What Ships Inside
| Component | Details |
|---|---|
| FROOT Knowledge | Knowledge modules across 5 layers (682KB) |
| BM25 Search Index | 358 documents Γ 8,627 terms, pre-computed IDF |
| Solution Plays | 100 pre-architected Azure AI solutions |
| AI Glossary | Comprehensive glossary extracted from modules |
| FAI Protocol | Manifest schema for play wiring |
| Architecture Guides | RAG, agents, hosting, cost, security |
Feature parity with the Node.js MCP server β same MCP tools, same knowledge, same FAI Engine.
Testing
pip install pytest
cd python-mcp
python -m pytest tests/ -v
# 43 tests across 9 test classesLinks
| Resource | Link |
|---|---|
| Website | frootai.devΒ |
| Setup Guide | FAI Packages SetupΒ |
| Python SDK | PyPI β frootaiΒ |
| Node MCP Server | npm β frootai-mcpΒ |
| VS Code Extension | MarketplaceΒ |
| Docker Image | GitHub Container RegistryΒ |
| GitHub | frootai/frootaiΒ |
| Contact | [email protected] |
Β© 2026 FrootAI β MIT License
AI architecture Β· MCP Β· model-context-protocol Β· Python Β· Azure Β· RAG Β· agents Β· copilot Β· semantic-kernel Β· open-source Β· frootai