server.py               ← entry point — assembles everything
config/settings.py      ← ALL configuration  ← EDIT THIS FIRST
│
├── providers/          FastMCP 3.0 Dynamic Providers
│   └── registry.py     FileSystemProvider · OpenAPIProvider · ProxyProvider
│
├── transforms/         FastMCP 3.0 Transforms (middleware for providers)
│   └── pipeline.py     PrefixTransform · VersionFilter · TagFilter
│
├── tools/
│   ├── meta_tools.py   search_tools (Search Transform) · unlock_role (progressive disclosure)
│   └── example_tools.py  ← template for your own tools; drop files here
│
├── resources/
│   └── templates.py    Parameterised URIs: enterprise://tables/{name}/schema
│
├── middleware/
│   └── stack.py        Logging · RateLimiting · ResponseLimiting · Caching
│
├── auth/
│   └── setup.py        JWT · OAuth 2.1 · Bearer
│
└── utils/
    ├── lifespan.py     Startup / shutdown hooks
    └── otel.py         OpenTelemetry tracing

# 1. Install
pip install fastmcp>=3.4.1 httpx

# 2. Configure
#    Open config/settings.py and fill every  <CONFIGURE>  marker.

# 3. Run (development — hot reload)
fastmcp dev server.py

# 4. Run (production)
python server.py

pip install fastmcp[tasks]   # background tasks via Docket
pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http  # OTEL

# tools/my_api_tools.py
from fastmcp import FastMCP, Context

mcp = FastMCP("my-api")

@mcp.tool(tags={"data", "read"}, version="1.0")
async def get_report(report_id: str, ctx: Context) -> dict:
    """Fetch an enterprise report by ID."""
    # ... your implementation
    return {}

LLM calls search_tools(query="show me revenue by region")
         │
         ▼
   Your retrieval API  (SEMANTIC_SEARCH.api_base_url)
         │
         ▼
   Top-K tools above score_threshold returned to LLM
         │
         ▼
   LLM calls the specific tool it needs

Client sends  tools/list  (no cursor)
         │
         ▼
   Server returns  page 1  (LIST_PAGE_SIZE items) + nextCursor
         │
         ▼
   Client sends  tools/list?cursor=<nextCursor>
         │
         ▼
   ... repeat until nextCursor is null

pip install pytest pytest-asyncio
pytest tests/