# __NAME__ Tool Scaffold
This directory was generated by `bin/mcp-bash scaffold tool __NAME__`.
Key files:
- `tool.sh` sources `${MCP_SDK}/tool-sdk.sh` (set by the framework when running tools) so you can call helpers like `mcp_args_require`, `mcp_args_get`, `mcp_json_obj`, `mcp_progress`, `mcp_log`, and response envelope helpers (`mcp_result_success`, `mcp_result_error`, `mcp_json_truncate`). See [SDK Discovery](../../README.md#sdk-discovery) for details.
- `tool.meta.json` advertises arguments and an `outputSchema` so clients receive both structured and text responses, per protocol spec.
Next steps:
1. Implement your tool logic inside `tool.sh`, replacing the greeting with real behaviour.
2. Adjust `tool.meta.json` to document any required arguments, timeouts, or structured output.
3. Check out `examples/02-logging-and-levels` and `examples/03-progress-and-cancellation` for patterns that build on the SDK helpers.
4. Run `./smoke.sh` after edits to validate JSON output. Update the sample args in `smoke.sh` if you change `tool.meta.json`.
Run `mcp-bash` after editing to ensure the tool loads and passes the integration tests under `test/integration/test_tools.sh`.
