OriginSelect MCP Server

Servidor MCP de OriginSelect

Servidor de Protocolo de Contexto de Modelo (MCP) para OriginSelect — busca productos y marcas éticas y verificadas por origen mediante agentes de IA.

Funciona con Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP.

Inicio Rápido

Opción 1: npx (recomendado)

No requiere instalación — solo añádelo a tu configuración de Claude Desktop:

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

Opción 2: Instalación global

npm install -g originselect-mcp-server

Luego añádelo a la configuración de Claude Desktop:

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

Opción 3: Desde el código fuente

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

Añádelo a tu configuración de MCP:

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

Consultas de Ejemplo

Una vez conectado, pregúntale a tu asistente de IA:

• "Encuentra productos orgánicos para bebés de Canadá por menos de $25"
• "Muéstrame marcas de café propiedad de mujeres en EE. UU."
• "¿Qué marcas de cuidado de la piel certificadas B Corp tienes?"
• "Encuentra productos para mascotas veganos y libres de crueldad"

Herramientas

search_products

Busca en el catálogo de productos curado por valores, país, categoría, marca o palabras clave.

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

Parámetro	Tipo	Descripción
query	string	Consulta opcional en lenguaje natural para contexto
country	string	País de origen (Canadá, EE. UU.)
category	string	Categoría de producto (Belleza, Bebé, Cuidado de mascotas, etc.)
values	string[]	Valores éticos (propiedad de mujeres, orgánico, b-corp, etc.)
brand	string	Nombre de la marca
keywords	string[]	Palabras clave del producto (champú, café, etc.)
priceMax	number	Precio máximo en dólares
market	string	canada, global o all (predeterminado: todos)
limit	number	Máximo de productos (1-50, predeterminado: 12)

search_brands

Descubre marcas por valores éticos, país o categoría.

Parámetro	Tipo	Descripción
country	string	País de origen
values	string[]	Valores éticos
category	string	Categoría de producto
brand	string	Nombre de la marca a consultar
market	string	Alcance del mercado
limit	number	Máximo de marcas (1-20, predeterminado: 10)

refine_search

Refina una búsqueda anterior añadiendo/eliminando filtros. Toma el objeto intent de una respuesta search_products previa y aplica modificaciones — no es necesario volver a consultar desde cero.

{
  "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

Lista los 21 valores éticos/de propiedad admitidos (propiedad de mujeres, b-corp, orgánico, etc.).

get_categories

Lista las 17 categorías de productos admitidas.

get_countries

Lista todos los países de origen admitidos (actualmente Canadá y EE. UU.).

Herramientas de inteligencia de primera parte

Evidencia propietaria de tráfico/ingresos de OriginSelect — requiere INTELLIGENCE_API_KEY (consulta Variables de Entorno). Cada respuesta está acotada, incluye ventana de fechas y contexto de frescura, y etiqueta la atribución como deterministic/aggregate/inferred para que sepas cuánto confiar en cada número. Estas herramientas responden "qué está pasando con nuestro propio sitio", no investigación web pública (SERP, competidores) — haz eso por separado con tus propias herramientas de búsqueda/navegación.

Herramienta	Propósito
get_daily_priorities	Oportunidades mejor clasificadas con evidencia y códigos de razón
get_page_performance	Rendimiento multicanal para una URL
get_query_performance	Rendimiento de una consulta en motores y páginas
get_page_queries	Consultas que generan tráfico a una página
get_query_pages	Páginas que clasifican para una consulta
get_ranking_changes	Ganancias/pérdidas en las consultas de una página a lo largo del tiempo
get_ctr_opportunities	Páginas/consultas con CTR bajo para su posición
get_cannibalization	Consultas con visibilidad de página superpuesta
get_channel_performance	Desglose de Google/Bing/Pinterest/IA para una página
get_affiliate_performance	Clics/ingresos/comisiones de afiliados por programa+mercado
get_ai_referral_performance	Comportamiento de referidos de motores de IA para una página
get_change_history	Cambios registrados de compilación/contenido para una página
get_data_freshness	Estado del conector para cada fuente de inteligencia

Arquitectura

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

Variables de Entorno

Variable	Predeterminado	Descripción
API_BASE_URL	https://api.originselect.com	URL base de la API de descubrimiento
INTELLIGENCE_API_KEY	(ninguno)	Requerida solo para las herramientas de inteligencia listadas arriba; la búsqueda de productos funciona sin ella

Valores Admitidos

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

Seguridad y Confianza

Este servidor MCP es de código abierto y totalmente auditable:

• Solo lectura — solo realiza solicitudes HTTPS salientes a api.originselect.com
• Sin acceso al sistema de archivos — no lee ni escribe ningún archivo local
• Sin telemetría — no envía datos de usuario ni análisis a ningún lugar
• Dependencias mínimas — una sola dependencia de ejecución (@modelcontextprotocol/sdk)
• Código fuente — github.com/chhavimishra/originselect-mcp-server

Consulta SECURITY.md para reportar vulnerabilidades.

Licencia

MIT