home / mcp / tennis warehouse mcp server

Tennis Warehouse MCP Server

Provides a secure MCP wrapper around Tennis Warehouse internal Solr product data, exposing safe, filtered queries to LLMs.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "avimunk1-tennis-warehouse-mcp": {
      "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"
      }
    }
  }
}

You have a secure MCP wrapper that lets you access Tennis Warehouse product data through an isolated, safe bridge to the internal Solr search API. It filters data for relevance, validates inputs, rates requests, and presents clean errors, so you can query product details, categories, deals, and stock status without exposing sensitive internal information.

How to use

After you start the Tennis Warehouse MCP Server, you can interact with it through an MCP client to perform natural language queries. Use the available tools to search products, bags, racquets, and shoes, check availability, fetch categories, and discover current deals. Craft prompts in plain language such as “Find lightweight racquets under $200” or “Show me Nike women’s shoes for hard courts,” and the MCP Server will translate them into safe, structured requests to retrieve relevant results.

Tips for effective usage: - Start with broad queries and tighten with filters like brand, weight, gender, or court type. - Verify availability before you plan a purchase from the results. - Explore current deals to identify savings without overloading your prompt with excessive data.

How to install

# Prerequisites
# - A system with Python 3.x installed
# - Network access to install Python packages

# 1. Create a 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"
      }
    }
  }
}
```

NOTE: Replace placeholder paths with your actual project paths. After saving the config, you will need to restart Claude Desktop to load the MCP server.

Additional notes

Environment variables that control the MCP runtime are exposed to Claude Desktop as shown. If you adjust TW_API_TIMEOUT or TW_MAX_RESULTS, the MCP server will apply these settings to subsequent queries.

Available tools

search_tennis_products

Search Tennis Warehouse products with intelligent filtering across categories and attributes.

search_tennis_bags

Search for tennis bags with advanced filtering by style, brand, and other attributes.

search_tennis_racquets

Find racquets filtered by brand and weight range.

search_tennis_shoes

Search tennis shoes filtered by gender, brand, and court type.

get_product_categories

Retrieve all available product categories with counts.

check_product_availability

Check if a specific product is in stock.

get_tennis_deals

Find current deals and discounts on tennis products.