Project structure

<project-root>/
├── .env
├── golf.json
├── pre_build.py
├── prompts/
│   └── example_prompt.py
├── resources/
│   └── example_resource.py
│   └── sub_category/
│       └── nested_resource.py
│       └── common.py
└── tools/
    └── example_tool.py
    └── payments/
        └── common.py
        └── get_balance.py
        └── transaction/
            └── submit.py

• golf.json: The main configuration file (see Configuration).
• .env: Stores environment variables. Loaded by the built server.
• pre_build.py: Optional script for pre-build tasks, like auth setup.
• tools/: Contains Python files defining your server’s tools (callable functions).
• resources/: Contains Python files defining data resources the LLM can read.
• prompts/: Contains Python files defining reusable prompt templates.

​

Component discovery

• Each .py file within tools/, resources/, or prompts/ (and their subdirectories) is treated as a single component.
• Files named __init__.py are ignored for direct component definition but are essential for Python’s packaging if you structure your components as modules.
• Files named common.py are special and used for shared code (see common.py section).

​

Component ID derivation

• tools/hello.py -> ID: hello
• tools/payments/transaction/submit.py -> ID: submit-transaction-payments
• resources/weather/current.py -> ID: current-weather