get_categories
List all supported product categories that can be used to filter products and brands.
LABSCO SUMMARY
Three of the six tools exist to tell you what the filters accept, which is the difference between a filter that works and one that quietly returns nothing.
A catalogue search behind an agent fails in a specific way: the model invents a plausible filter value, the API matches nothing, and the empty result reads as 'no such products exist' rather than 'that is not a token we use'. get_values, get_categories and get_countries are the fix, and spending half the tool surface on them is a deliberate trade. refine_search is the other considered piece — it carries the parsed intent forward instead of re-deriving it, so a follow-up narrows the search you actually ran rather than a fresh interpretation of the original sentence. Coverage is limited to Canada and the USA.
What it is
A search client for OriginSelect's curated catalogue, with six tools: two searches, one refinement, and three that enumerate the values you are allowed to filter on.
What you get
- search_products and search_brands take the same filters — country of origin, ethical values, category, brand and price — and return products or the brands behind them.
- refine_search takes the intent object from a previous search and applies changes to it, so narrowing a result does not re-parse the original question.
- get_values, get_categories and get_countries return the canonical tokens the filters accept, which is what stops a filter from silently matching nothing.
- Country coverage is Canada and the USA, stated by get_countries rather than left to be discovered.
Requirements
Nothing to supply — npx runs it with no credentials. Running from source instead lets you point it at a different API host.
Setup effort
One command — npx originselect-mcp-server
USE CASES
01
Finding products that meet a specific ethical criterion
Check the canonical value tokens first, then search on them — so 'women-owned' or 'B Corp' matches what the catalogue actually stores rather than a guess at the wording.
02
Narrowing a result you already have
Apply a price cap or a country filter to the previous search by passing its intent object back, instead of re-asking the whole question.
03
Going from a product to the brand behind it
Search brands on the same filters to see who makes what, with the brand details rather than a product listing.
6 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_countries
List all supported countries of origin that can be used to filter products and brands. Currently supports Canada and USA.
get_values
List all supported ethical/ownership values that can be used to filter products and brands. Returns canonical value tokens with display labels.
refine_search
Refine a previous product search by adding/removing filters. Takes the intent object from a prior search_products response and applies modifications. No new query parsing needed — this is a fast refinement.
Examples:
- Add a value: { action: "add", field: "values", value: "organic" }
- Remove a value: { action: "remove", field: "values", value: "vegan" }
- Change country: { action: "modify", field: "country", value: "Canada" }
- Set max price: { action: "modify", field: "priceMax", value: 30 }
- Change category: { action: "modify", field: "category", value: "Beauty" }
search_brands
Search for ethical and origin-verified brands on OriginSelect. Filter by country of origin, ethical values (women-owned, b-corp, organic, etc.), and product category. Returns brand details including values, website, and product count.
search_products
Search OriginSelect's curated catalog of ethical, origin-verified products. Filter by country of origin, ethical values (e.g., women-owned, organic, b-corp), product category, brand, and price. Returns scored and ranked results with match reasons.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 6 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"originselect-mcp-server": {
"command": "npx",
"args": [
"originselect-mcp-server"
]
}
}
}npx
TERMINAL
npx originselect-mcp-server
