{
  "markdown": "# OriginSelect MCP Server\n\n[![npm version](https://img.shields.io/npm/v/originselect-mcp-server)](https://www.npmjs.com/package/originselect-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nModel Context Protocol server for [OriginSelect](https://originselect.com) — search ethical, origin-verified products and brands via AI agents.\n\nWorks with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.\n\n## Quick Start\n\n### Option 1: npx (recommended)\n\nNo install needed — just add to your Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"originselect\": {\n      \"command\": \"npx\",\n      \"args\": [\"originselect-mcp-server\"]\n    }\n  }\n}\n```\n\n### Option 2: Global install\n\n```bash\nnpm install -g originselect-mcp-server\n```\n\nThen add to Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"originselect\": {\n      \"command\": \"originselect-mcp-server\"\n    }\n  }\n}\n```\n\n### Option 3: From source\n\n```bash\ngit clone https://github.com/chhavimishra/originselect-mcp-server.git\ncd originselect-mcp-server\nnpm install\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"originselect\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/originselect-mcp-server/src/index.js\"],\n      \"env\": {\n        \"API_BASE_URL\": \"https://api.originselect.com\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nAdd to your MCP settings:\n\n```json\n{\n  \"originselect\": {\n    \"command\": \"npx\",\n    \"args\": [\"originselect-mcp-server\"]\n  }\n}\n```\n\n## Example Queries\n\nOnce connected, ask your AI assistant:\n\n- *\"Find organic baby products from Canada under $25\"*\n- *\"Show me women-owned coffee brands in the US\"*\n- *\"What B Corp certified skincare brands do you have?\"*\n- *\"Find vegan, cruelty-free pet products\"*\n\n## Tools\n\n### `search_products`\n\nSearch the curated product catalog by values, country, category, brand, or keywords.\n\n```\n\"Find organic baby products from Canada under $25\"\n→ { country: \"Canada\", category: \"Baby\", values: [\"organic\"], priceMax: 25 }\n```\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `query` | string | Optional NL query for context |\n| `country` | string | Country of origin (Canada, USA) |\n| `category` | string | Product category (Beauty, Baby, Pet Care, etc.) |\n| `values` | string[] | Ethical values (women-owned, organic, b-corp, etc.) |\n| `brand` | string | Brand name |\n| `keywords` | string[] | Product keywords (shampoo, coffee, etc.) |\n| `priceMax` | number | Maximum price in dollars |\n| `market` | string | `canada`, `global`, or `all` (default: all) |\n| `limit` | number | Max products (1-50, default: 12) |\n\n### `search_brands`\n\nDiscover brands by ethical values, country, or category.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `country` | string | Country of origin |\n| `values` | string[] | Ethical values |\n| `category` | string | Product category |\n| `brand` | string | Brand name to look up |\n| `market` | string | Market scope |\n| `limit` | number | Max brands (1-20, default: 10) |\n\n### `refine_search`\n\nRefine 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.\n\n```json\n{\n  \"intent\": { \"...from previous response...\" },\n  \"modifications\": [\n    { \"action\": \"add\", \"field\": \"values\", \"value\": \"organic\" },\n    { \"action\": \"remove\", \"field\": \"values\", \"value\": \"vegan\" },\n    { \"action\": \"modify\", \"field\": \"priceMax\", \"value\": 30 }\n  ]\n}\n```\n\n### `get_values`\n\nList all 21 supported ethical/ownership values (women-owned, b-corp, organic, etc.).\n\n### `get_categories`\n\nList all 17 supported product categories.\n\n### `get_countries`\n\nList all supported countries of origin (currently Canada and USA).\n\n### First-party intelligence tools\n\nProprietary OriginSelect traffic/revenue evidence — requires `INTELLIGENCE_API_KEY`\n(see Environment Variables). Every response is bounded, includes date-window and\nfreshness context, and labels attribution as `deterministic`/`aggregate`/`inferred`\nso you know how much to trust each number. These tools answer \"what's going on\nwith our own site,\" not public-web research (SERPs, competitors) — do that\nseparately with your own search/browse tools.\n\n| Tool | Purpose |\n|---|---|\n| `get_daily_priorities` | Top ranked opportunities with evidence and reason codes |\n| `get_page_performance` | Cross-channel performance for one URL |\n| `get_query_performance` | One query's performance across engines and pages |\n| `get_page_queries` | Queries driving traffic to one page |\n| `get_query_pages` | Pages ranking for one query |\n| `get_ranking_changes` | Gains/losses in a page's queries over time |\n| `get_ctr_opportunities` | Low-CTR-for-position pages/queries |\n| `get_cannibalization` | Queries with overlapping page visibility |\n| `get_channel_performance` | Google/Bing/Pinterest/AI breakdown for one page |\n| `get_affiliate_performance` | Affiliate clicks/revenue/commission by program+market |\n| `get_ai_referral_performance` | AI-engine referral behavior for one page |\n| `get_change_history` | Logged build/content changes for one page |\n| `get_data_freshness` | Connector status for every intelligence source |\n\n## Architecture\n\n```\nAI Agent (Claude, GPT, Cursor)\n    │\n    │  MCP (stdio)\n    ▼\n┌─────────────────────────┐\n│  MCP Server (this pkg)  │\n│  19 tools               │\n└───────────┬─────────────┘\n            │  HTTPS\n            ▼\n┌─────────────────────────┐\n│  OriginSelect API       │\n│  api.originselect.com   │\n└─────────────────────────┘\n```\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `API_BASE_URL` | `https://api.originselect.com` | Discovery API base URL |\n| `INTELLIGENCE_API_KEY` | _(none)_ | Required only for the intelligence tools listed above; product search works without it |\n\n## Supported Values\n\n```\nwomen-owned · black-owned · indigenous-owned · veteran-owned\nfamily-owned · lgbtq-owned · aapi-owned · latino-owned · minority-owned\nb-corp · organic · sustainable · vegan · non-gmo · fair-trade\nnon-toxic · cruelty-free · fragrance-free · plastic-free\nsocial-impact · gluten-free\n```\n\n## Security & Trust\n\nThis MCP server is **open source** and fully auditable:\n\n- **Read-only** — only makes outbound HTTPS requests to `api.originselect.com`\n- **No filesystem access** — does not read or write any local files\n- **No telemetry** — does not send user data or analytics anywhere\n- **Minimal dependencies** — single runtime dependency (`@modelcontextprotocol/sdk`)\n- **Source code** — [github.com/chhavimishra/originselect-mcp-server](https://github.com/chhavimishra/originselect-mcp-server)\n\nSee [SECURITY.md](SECURITY.md) for vulnerability reporting.\n\n## License\n\nMIT\n",
  "bytes": 6786,
  "sha": "e95e02a2eec63be2be182de371b33e1904528b1fe0e46d64fffe305c97135c92",
  "repo_slug": "chhavimishra/originselect-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_chhavimishra_originselect_mcp__a5afb315/readme"
}