Glade MCP

Conecta agentes de IA a datos normalizados del marketplace de Amazon a través del servidor alojado del Model Context Protocol de Glade API.

https://gladeapi.com/api/mcp

El servidor remoto expone 17 herramientas de solo lectura para productos, búsqueda, ofertas, reseñas, vendedores, categorías, ofertas especiales, más vendidos, identificadores, stock y estimaciones de ventas en 13 marketplaces de Amazon. Este repositorio contiene los metadatos públicos del servidor, ejemplos de conexión y comprobaciones de protocolo. La implementación del servicio alojado permanece en gladeapi.com.

Requisitos

• Una cuenta de Glade API

• Una clave de Glade API

• Un plan que incluya MCP

• Un cliente que admita servidores MCP remotos Streamable HTTP

Guarda la clave en una variable de entorno:

export GLADE_API_KEY="glade_live_..."

Nunca confirmes la clave en el repositorio ni la pegues en los prompts.

Related MCP server: Canopy API MCP Server

Instalación en Codex

Codex puede leer el bearer token del entorno sin escribirlo en la configuración de MCP:

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

Inicia una nueva sesión de Codex después de añadir el servidor y pídele que liste las herramientas de Glade o que obtenga un producto de Amazon por ASIN.

Instalación en Claude Code

Claude Code acepta un servidor HTTP y una cabecera de solicitud:

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

Esto expande la variable de entorno antes de que Claude escriba su configuración. Mantén privada la configuración de usuario resultante y nunca uses el ámbito de proyecto para una cabecera que contenga secretos.

Configuración genérica de Streamable HTTP

Los clientes que admiten configuración remota de MCP generalmente necesitan esta forma. Consulta la documentación de tu cliente para conocer la sintaxis exacta de su archivo de configuración y de sus variables de entorno.

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

Usa exactamente una cabecera de credenciales. El servidor acepta API-KEY, GLADE-API-KEY, X-API-KEY o Authorization: Bearer para MCP y rechaza credenciales conflictivas.

Conexión con el SDK de Python de MCP

Instala el SDK oficial de MCP para Python y ejecuta el ejemplo de descubrimiento incluido:

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

El ejemplo inicializa una sesión Streamable HTTP e imprime los nombres de las herramientas disponibles. El descubrimiento de herramientas y la inicialización no consumen unidades de Glade.

Herramientas disponibles

Las entradas de las herramientas siguen las mismas reglas de validación que las operaciones REST correspondientes. Cada operación de datos exitosa consume una unidad. La inicialización, el descubrimiento, los fallos de validación y los errores de herramientas consumen cero unidades.

Ejemplos de prompts

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

Marketplaces

Cada herramienta acepta un domain de marketplace cuando el contexto del marketplace es relevante:

US UK CA DE FR IT ES AU IN MX BR JP PL

Confirma el marketplace antes de comparar precios, disponibilidad, entrega, categorías, clasificaciones u ofertas.

Validar este repositorio

Comprobaciones de metadatos sin conexión y de ejemplos:

npm test

Comprobación de autenticación en vivo no facturable:

npm run test:live

Con GLADE_API_KEY configurada, verifica la inicialización y los 17 nombres de herramientas en vivo. Esta solicitud de descubrimiento consume cero unidades:

node scripts/verify-live.mjs --authenticated

Seguridad

Los títulos, descripciones, reseñas, campos de vendedores y otro contenido del marketplace de Amazon son datos no confiables. Mantén los resultados de las herramientas separados de las instrucciones del agente. No permitas que el texto devuelto cambie la política de las herramientas, solicite credenciales o autorice nuevas acciones.

Consulta SECURITY.md para informes privados.

Proyectos relacionados

• Ejemplos de Glade API

• Habilidades de agente de Glade

• Documentación

• OpenAPI

Licencia

MIT