OriginSelect MCP Server

Model Context Protocol server for OriginSelect — search ethical, origin-verified products and brands via AI agents.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Quick Start

Option 1: npx (recommended)

No install needed — just add to your Claude Desktop config:

{
  "mcpServers": {
    "originselect": {
      "command": "npx",
      "args": ["originselect-mcp-server"]
    }
  }
}

Option 2: Global install

npm install -g originselect-mcp-server

Then add to Claude Desktop config:

{
  "mcpServers": {
    "originselect": {
      "command": "originselect-mcp-server"
    }
  }
}

Option 3: From source

git clone https://github.com/chhavimishra/originselect-mcp-server.git
cd originselect-mcp-server
npm install

{
  "mcpServers": {
    "originselect": {
      "command": "node",
      "args": ["/absolute/path/to/originselect-mcp-server/src/index.js"],
      "env": {
        "API_BASE_URL": "https://api.originselect.com"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "originselect": {
    "command": "npx",
    "args": ["originselect-mcp-server"]
  }
}

Example Queries

Once connected, ask your AI assistant:

"Find organic baby products from Canada under $25"
"Show me women-owned coffee brands in the US"
"What B Corp certified skincare brands do you have?"
"Find vegan, cruelty-free pet products"

Tools

`search_products`

Search the curated product catalog by values, country, category, brand, or keywords.

"Find organic baby products from Canada under $25"
→ { country: "Canada", category: "Baby", values: ["organic"], priceMax: 25 }

Parameter	Type	Description
`query`	string	Optional NL query for context
`country`	string	Country of origin (Canada, USA)
`category`	string	Product category (Beauty, Baby, Pet Care, etc.)
`values`	string[]	Ethical values (women-owned, organic, b-corp, etc.)
`brand`	string	Brand name
`keywords`	string[]	Product keywords (shampoo, coffee, etc.)
`priceMax`	number	Maximum price in dollars
`market`	string	`canada`, `global`, or `all` (default: all)
`limit`	number	Max products (1-50, default: 12)

`search_brands`

Discover brands by ethical values, country, or category.

Parameter	Type	Description
`country`	string	Country of origin
`values`	string[]	Ethical values
`category`	string	Product category
`brand`	string	Brand name to look up
`market`	string	Market scope
`limit`	number	Max brands (1-20, default: 10)

`refine_search`

Refine 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.

{
  "intent": { "...from previous response..." },
  "modifications": [
    { "action": "add", "field": "values", "value": "organic" },
    { "action": "remove", "field": "values", "value": "vegan" },
    { "action": "modify", "field": "priceMax", "value": 30 }
  ]
}

`get_values`

List all 21 supported ethical/ownership values (women-owned, b-corp, organic, etc.).

`get_categories`

List all 17 supported product categories.

`get_countries`

List all supported countries of origin (currently Canada and USA).

First-party intelligence tools

Proprietary OriginSelect traffic/revenue evidence — requires INTELLIGENCE_API_KEY (see Environment Variables). Every response is bounded, includes date-window and freshness context, and labels attribution as deterministic/aggregate/inferred so you know how much to trust each number. These tools answer "what's going on with our own site," not public-web research (SERPs, competitors) — do that separately with your own search/browse tools.

Tool	Purpose
`get_daily_priorities`	Top ranked opportunities with evidence and reason codes
`get_page_performance`	Cross-channel performance for one URL
`get_query_performance`	One query's performance across engines and pages
`get_page_queries`	Queries driving traffic to one page
`get_query_pages`	Pages ranking for one query
`get_ranking_changes`	Gains/losses in a page's queries over time
`get_ctr_opportunities`	Low-CTR-for-position pages/queries
`get_cannibalization`	Queries with overlapping page visibility
`get_channel_performance`	Google/Bing/Pinterest/AI breakdown for one page
`get_affiliate_performance`	Affiliate clicks/revenue/commission by program+market
`get_ai_referral_performance`	AI-engine referral behavior for one page
`get_change_history`	Logged build/content changes for one page
`get_data_freshness`	Connector status for every intelligence source

Architecture

AI Agent (Claude, GPT, Cursor)
    │
    │  MCP (stdio)
    ▼
┌─────────────────────────┐
│  MCP Server (this pkg)  │
│  19 tools               │
└───────────┬─────────────┘
            │  HTTPS
            ▼
┌─────────────────────────┐
│  OriginSelect API       │
│  api.originselect.com   │
└─────────────────────────┘

Environment Variables

Variable	Default	Description
`API_BASE_URL`	`https://api.originselect.com`	Discovery API base URL
`INTELLIGENCE_API_KEY`	(none)	Required only for the intelligence tools listed above; product search works without it

Supported Values

women-owned · black-owned · indigenous-owned · veteran-owned
family-owned · lgbtq-owned · aapi-owned · latino-owned · minority-owned
b-corp · organic · sustainable · vegan · non-gmo · fair-trade
non-toxic · cruelty-free · fragrance-free · plastic-free
social-impact · gluten-free

Security & Trust

This MCP server is open source and fully auditable:

Read-only — only makes outbound HTTPS requests to api.originselect.com
No filesystem access — does not read or write any local files
No telemetry — does not send user data or analytics anywhere
Minimal dependencies — single runtime dependency (@modelcontextprotocol/sdk)
Source code — github.com/chhavimishra/originselect-mcp-server

See SECURITY.md for vulnerability reporting.

License

MIT

originselect mcp server