On Running MCP
About
An MCP server for interacting with the On Running API
Explore
- Query the On Running API with optional filters.
- Get all product names from query results.
- Retrieve activities associated with each product.
- Filter products by name with filter_by_product_name.
- Get an image for a specific product.
- List product types, subtypes, and gender options.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
On Running MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Requires Python 3.12+
A Model-Context-Protocol (MCP) server for interacting with the On Running website API.
uv venv
cd on_running_mcp
uv run mcp install server.py
```
> I am running a marathon later this month, can you help me to find a pair of socks for running in?
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)
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)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"on running mcp": {
"on-running-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"on-running-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}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+
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
