mcpField
O
On Running MCP

On Running MCP

Local
github.com/scott-clare1Business & Marketing0Updated 81w ago
Repository

About On Running MCP

On Running MCP is a FastMCP server for querying product data from the On Running website API. It is for clients that need product details and filters such as type, subtype, or gender.

Key features

  1. 01Query product data with filters
  2. 02Retrieve names, images, and activities
  3. 03Find products by name
  4. 04List type, subtype, and gender options

Use cases

  1. 01Find running socks for a marathon
  2. 02Browse products by type or gender
  3. 03Retrieve images and activities for products

MCP support

The server exposes tools for querying the On Running API and retrieving or filtering product information through MCP.

#on-running#mcp#api-interaction

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.