on-running-mcp
3.1
If you are the rightful owner of on-running-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model-Context-Protocol (MCP) server for interacting with the On Running website API.
On Running MCP
A Model-Context-Protocol (MCP) server for interacting with the On Running website API.
Overview
This project provides an interface to the On Running website's product data through a FastMCP server. It allows you to:
- Query the On Running API with various filters
- Get product information including names, images, and activities
- Filter products by type, subtype, and gender
Installation
Requires Python 3.12+
# Clone the repository
git clone https://github.com/yourusername/on-running-mcp.git
cd on-running-mcp
# Create and activate a virtual environment (optional but recommended)
uv venv
# Sync the dependencies
uv sync
Usage
Add the Server Config to Claude Desktop.
cd on_running_mcp
uv run mcp install server.py
Available Tools
The MCP server provides the following tools:
make_query: Make a query to the On Running API with optional filtersget_product_names: Get all product names from the resultsget_activities: Get activities associated with each productfilter_by_product_name: Find a specific product by nameget_product_image: Get an image for a specific productget_product_type_options: List available product types (shoes, apparel, accessories)get_product_subtype_options: List available product subtypes (tops, shorts, etc.)get_gender_options: List available gender options (men's, women's, kids)
Example Usage
I am running a marathon later this month, can you help me to find a pair of socks for running in?
Project Structure
on_running_mcp/: Main package directoryserver.py: MCP server implementation with tool definitionscore/: Core API implementationapi.py: On Running API clientschemas.py: Pydantic models for API data
