Watchbase MCP Server

🚀 WatchBase MCP Server

An MCP (Model Context Protocol) server that provides access to the WatchBase data feed API for querying watch metadata.

🚀 Quick Start

This MCP server offers access to the WatchBase data feed API, enabling users to query watch metadata. It provides structured access to a comprehensive database of watch information, facilitating developers to integrate detailed watch data into their applications.

✨ Features

This MCP server provides the following features:

1. Search: Search for watches based on a query string.
2. Search by Reference Number: Search for watches based on partial reference numbers (supports wildcards).
3. List Brands: Get a list of all available brands.
4. List Families: Get a list of families for a specified brand ID.
5. List Watches: Get a list of watches for a specific brand and/or family based on the brand ID and an optional family ID.
6. Get Watch Details: Get detailed information about a watch by its specified ID.

📦 Installation

Prerequisites

• Install Node.js and npm.
• Obtain a WatchBase API access key.

Steps

1. Clone the repository from GitHub:

git clone https://github.com/your-repository.git

2. Install dependencies in the project directory:

npm install

3. Build the server using the following command:

npm run build

📚 Documentation

Configuration

Set the API_KEY environment variable to your WatchBase API access key.

Cline/Roo Code Configuration Example

Add the following content to the config.json file:

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

Claude Desktop App Configuration Example

Add the following content to the config.json file:

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

About the WatchBase API

The WatchBase data feed API provides structured access to a comprehensive database of watch information, including brands, families (collections), specific models, reference numbers, technical details, and images. It allows developers to integrate its detailed watch data into their applications. For more information, refer to the WatchBase API documentation.

💻 Usage Examples

Here are usage examples for each tool:

Basic Usage

search Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search</tool_name>
  <arguments>
    {
      "q": "priors court"
    }
  </arguments>
</use_mcp_tool>

search_refnr Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search_refnr</tool_name>
  <arguments>
    {
      "q": "P2/"
    }
  </arguments>
</use_mcp_tool>

list_brands Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_brands</tool_name>
  <arguments>
    {}
  </arguments>
</use_mcp_tool>

list_families Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_families</tool_name>
  <arguments>
    {
      "brand_id": 37
    }
  </arguments>
</use_mcp_tool>

list_watches Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_watches</tool_name>
  <arguments>
    {
      "brand_id": 37,
      "family_id": 279
    }
  </arguments>
</use_mcp_tool>

get_watch_details Example

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>get_watch_details</tool_name>
  <arguments>
    {
      "id": 17289
    }
  </arguments>
</use_mcp_tool>

📄 License

This MCP server project is released under the MIT License - see the LICENSE file for details.

Please also refer to the WatchBase Terms of Service for regulations regarding API usage.