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 filters
• get_product_names: Get all product names from the results
• get_activities: Get activities associated with each product
• filter_by_product_name: Find a specific product by name
• get_product_image: Get an image for a specific product
• get_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 directory
  • server.py: MCP server implementation with tool definitions
  • core/: Core API implementation
    • api.py: On Running API client
    • schemas.py: Pydantic models for API data