OriginSelect MCP Server

1# OriginSelect MCP Server
2 
3[![npm version](https://img.shields.io/npm/v/originselect-mcp-server)](https://www.npmjs.com/package/originselect-mcp-server)
4[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5 
6Model Context Protocol server for [OriginSelect](https://originselect.com) — search ethical, origin-verified products and brands via AI agents.
7 
8Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
9 
10## Quick Start
11 
12### Option 1: npx (recommended)
13 
14No install needed — just add to your Claude Desktop config:
15 
16```json
17{
18  "mcpServers": {
19    "originselect": {
20      "command": "npx",
21      "args": ["originselect-mcp-server"]
22    }
23  }
24}
25```
26 
27### Option 2: Global install
28 
29```bash
30npm install -g originselect-mcp-server
31```
32 
33Then add to Claude Desktop config:
34 
35```json
36{
37  "mcpServers": {
38    "originselect": {
39      "command": "originselect-mcp-server"
40    }
41  }
42}
43```
44 
45### Option 3: From source
46 
47```bash
48git clone https://github.com/chhavimishra/originselect-mcp-server.git
49cd originselect-mcp-server
50npm install
51```
52 
53```json
54{
55  "mcpServers": {
56    "originselect": {
57      "command": "node",
58      "args": ["/absolute/path/to/originselect-mcp-server/src/index.js"],
59      "env": {
60        "API_BASE_URL": "https://api.originselect.com"
61      }
62    }
63  }
64}
65```
66 
67### Cursor / Windsurf
68 
69Add to your MCP settings:
70 
71```json
72{
73  "originselect": {
74    "command": "npx",
75    "args": ["originselect-mcp-server"]
76  }
77}
78```
79 
80## Example Queries
81 
82Once connected, ask your AI assistant:
83 
84- *"Find organic baby products from Canada under $25"*
85- *"Show me women-owned coffee brands in the US"*
86- *"What B Corp certified skincare brands do you have?"*
87- *"Find vegan, cruelty-free pet products"*
88 
89## Tools
90 
91### `search_products`
92 
93Search the curated product catalog by values, country, category, brand, or keywords.
94 
95```
96"Find organic baby products from Canada under $25"
97→ { country: "Canada", category: "Baby", values: ["organic"], priceMax: 25 }
98```
99 
100| Parameter | Type | Description |
101|-----------|------|-------------|
102| `query` | string | Optional NL query for context |
103| `country` | string | Country of origin (Canada, USA) |
104| `category` | string | Product category (Beauty, Baby, Pet Care, etc.) |
105| `values` | string[] | Ethical values (women-owned, organic, b-corp, etc.) |
106| `brand` | string | Brand name |
107| `keywords` | string[] | Product keywords (shampoo, coffee, etc.) |
108| `priceMax` | number | Maximum price in dollars |
109| `market` | string | `canada`, `global`, or `all` (default: all) |
110| `limit` | number | Max products (1-50, default: 12) |
111 
112### `search_brands`
113 
114Discover brands by ethical values, country, or category.
115 
116| Parameter | Type | Description |
117|-----------|------|-------------|
118| `country` | string | Country of origin |
119| `values` | string[] | Ethical values |
120| `category` | string | Product category |
121| `brand` | string | Brand name to look up |
122| `market` | string | Market scope |
123| `limit` | number | Max brands (1-20, default: 10) |
124 
125### `refine_search`
126 
127Refine a previous search by adding/removing filters. Takes the `intent` object from a prior `search_products` response and applies modifications — no need to re-query from scratch.
128 
129```json
130{
131  "intent": { "...from previous response..." },
132  "modifications": [
133    { "action": "add", "field": "values", "value": "organic" },
134    { "action": "remove", "field": "values", "value": "vegan" },
135    { "action": "modify", "field": "priceMax", "value": 30 }
136  ]
137}
138```
139 
140### `get_values`
141 
142List all 21 supported ethical/ownership values (women-owned, b-corp, organic, etc.).
143 
144### `get_categories`
145 
146List all 17 supported product categories.
147 
148### `get_countries`
149 
150List all supported countries of origin (currently Canada and USA).
151 
152## Architecture
153 
154```
155AI Agent (Claude, GPT, Cursor)
156    │
157    │  MCP (stdio)
158    ▼
159┌─────────────────────────┐
160│  MCP Server (this pkg)  │
161│  6 tools                │
162└───────────┬─────────────┘
163            │  HTTPS
164            ▼
165┌─────────────────────────┐
166│  OriginSelect API       │
167│  api.originselect.com   │
168└─────────────────────────┘
169```
170 
171## Environment Variables
172 
173| Variable | Default | Description |
174|----------|---------|-------------|
175| `API_BASE_URL` | `https://api.originselect.com` | Discovery API base URL |
176 
177## Supported Values
178 
179```
180women-owned · black-owned · indigenous-owned · veteran-owned
181family-owned · lgbtq-owned · aapi-owned · latino-owned · minority-owned
182b-corp · organic · sustainable · vegan · non-gmo · fair-trade
183non-toxic · cruelty-free · fragrance-free · plastic-free
184social-impact · gluten-free
185```
186 
187## Security & Trust
188 
189This MCP server is **open source** and fully auditable:
190 
191- **Read-only** — only makes outbound HTTPS requests to `api.originselect.com`
192- **No filesystem access** — does not read or write any local files
193- **No telemetry** — does not send user data or analytics anywhere
194- **Minimal dependencies** — single runtime dependency (`@modelcontextprotocol/sdk`)
195- **Source code** — [github.com/chhavimishra/originselect-mcp-server](https://github.com/chhavimishra/originselect-mcp-server)
196 
197See [SECURITY.md](SECURITY.md) for vulnerability reporting.
198 
199## License
200 
201MIT
202