
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