Tennis Warehouse MCP Server

🎾 Secure MCP wrapper for Tennis Warehouse's internal APIs

This MCP server provides LLMs with safe, business-friendly access to Tennis Warehouse product data through their internal Solr search API.

🛡️ Security Benefits

• API Gateway: Protects internal Tennis Warehouse APIs from direct LLM access
• Data Filtering: Only exposes customer-relevant product information
• Input Validation: Sanitizes and validates all search parameters
• Rate Limiting: Controls API usage and prevents abuse
• Error Handling: Clean error messages instead of internal stack traces

🔧 Installation

1. Create virtual environment:

   cd tennis-warehouse-mcp
   python3 -m venv .venv
   source .venv/bin/activate
   

2. Install dependencies:

   pip install "mcp[cli]" httpx requests pydantic
   

3. Configure Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

   {
     "mcpServers": {
       "tennis-warehouse": {
         "command": "/path/to/tennis-warehouse-mcp/.venv/bin/python3",
         "args": ["/path/to/tennis-warehouse-mcp/main.py"],
         "env": {
           "TW_API_TIMEOUT": "10",
           "TW_MAX_RESULTS": "20"
         }
       }
     }
   }
   

4. Restart Claude Desktop to load the new MCP server

🎯 Available Tools

search_tennis_products(query, category, max_results)

Search Tennis Warehouse products with intelligent filtering.

Example:

🤖 "Find Wilson racquets under $200"

search_tennis_bags(style, brand, max_results)

Search specifically for tennis bags with advanced filtering.

Example:

🤖 "Show me Head backpack tennis bags"

search_tennis_racquets(brand, weight_range, max_results)

Search for tennis racquets with brand and weight filtering.

Example:

🤖 "Find Babolat lightweight racquets"

search_tennis_shoes(gender, brand, court_type, max_results)

Search for tennis shoes with gender, brand, and court type filtering.

Example:

🤖 "Find Nike men's hard court tennis shoes"

get_product_categories()

Get all available product categories with product counts.

check_product_availability(product_name)

Check if a specific product is in stock.

Example:

🤖 "Is the Wilson Pro Staff 97 available?"

get_tennis_deals(category, max_results)

Find current deals and discounted tennis products.

Example:

🤖 "Show me current racquet deals"

📊 What LLMs Get vs. Internal API

LLM Gets (Safe)	Internal API Has (Protected)
✅ Product name, brand, price	❌ Internal product IDs
✅ Availability status	❌ Exact inventory counts
✅ Public product URLs	❌ Supplier costs
✅ Category information	❌ Restock schedules
✅ Clean error messages	❌ Database stack traces

🔍 Example Tennis Warehouse API Mapping

Internal Solr API:

https://static.tennis-warehouse.com/solr/solr_query.php?search=products&facet_set%5B%5D=facet_set_BAGFILTER&filter_cat=SHOULDBAGS

MCP Tool:

search_tennis_bags(style="backpack", brand="Wilson")

LLM Result:

[
  {
    "name": "Wilson Pro Staff Backpack",
    "brand": "Wilson", 
    "price": "$89.99",
    "availability": "Available",
    "product_url": "https://www.tennis-warehouse.com/..."
  }
]

⚙️ Configuration

Environment variables can be set in Claude Desktop config:

• TW_API_TIMEOUT: API timeout in seconds (default: 10)
• TW_MAX_RESULTS: Maximum results per query (default: 20)

🧪 Testing

Test the API client:

source .venv/bin/activate
python3 -c "
from tennis_warehouse_api import TennisWarehouseAPI
api = TennisWarehouseAPI()
print('✅ Tennis Warehouse API client working!')
"

🏗️ Architecture

🤖 LLM (Claude)
    ↓ (MCP Protocol)
🛡️ Tennis Warehouse MCP Server
    ↓ (HTTP/JSON)
🔒 Tennis Warehouse Internal Solr API
    ↓
📊 Product Database

🎾 LLM Usage Examples

Once configured, LLMs can use natural language to search Tennis Warehouse:

• "Find me Wilson tennis bags under $100"
• "What Nike tennis shoes are available for women?"
• "Show me current deals on Babolat racquets"
• "Is the Head Speed MP racquet in stock?"
• "Find lightweight tennis racquets for beginners"

The MCP server handles all the complexity of mapping these requests to the internal Solr API while keeping sensitive data protected! 🎾✨