def register_documentation_resources(mcp):
# Resources (for providing information about the Turbify Store API)
@mcp.resource("turbify-store://api-docs")
async def turbify_store_api_docs() -> str:
"""Documentation for the Turbify Store Catalog API"""
return """
# Turbify Store Catalog API Documentation
## Overview
This MCP server provides tools to interact with the Turbify Store Catalog API for managing your store's inventory.
## Available Tools
### create_catalog_item
Create a new item in your catalog.
- **item_id**: Unique identifier (required)
- **name**: Item display name (required)
- **table_id**: Category/table ID (required)
- **price**: Regular price (required)
- **sale_price**: Sale price (optional)
- **orderable**: "yes" or "no" (default: "yes")
- **taxable**: "yes" or "no" (default: "yes")
### update_catalog_item
Update an existing item.
- **item_id**: ID of item to update (required)
- All other parameters are optional
### delete_catalog_item
Remove an item from your catalog.
- **item_id**: ID of item to delete (required)
### search_catalog_items
Search for items in your catalog.
- **keyword**: Search term (required)
- **start_index**: Pagination start (default: 1)
- **end_index**: Pagination end (default: 100, max: 1000)
### get_store_config
View current store configuration and API settings.
## Environment Variables Required
- **TURBIFY_STORE_ID**: Your Turbify Store ID
- **TURBIFY_CONTRACT_TOKEN**: Your contract token for API access
## Error Handling
All tools return JSON responses with status information. Check the "status" field:
- "success": Operation completed successfully
- "error": Operation failed, check "errors" array for details
"""