Motomarks MCP
Cada logotipo de coche, una API simple.
Documentación
Servidor Motomarks MCP
El servidor oficial del Model Context Protocol (MCP) para Motomarks: un puente alojado en la nube que brinda a tus herramientas de IA acceso seguro y en tiempo real a la API de logotipos de automóviles Motomarks y a la CDN de imágenes.
Registro MCP: io.motomarks/mcp · Autenticación: OAuth 2.1 o clave API · Alojamiento: Motomarks Cloud
El servidor Motomarks MCP conecta clientes compatibles con MCP a la biblioteca de marcas de Motomarks. Una vez configurado, tus herramientas de IA pueden buscar marcas automotrices, obtener datos de marcas y paletas de colores, explorar activos de logotipos y generar URL de imágenes CDN listas para incrustar. La autenticación utiliza OAuth 2.1 (inicio de sesión en el navegador) o una clave API secreta de Motomarks, por lo que cada solicitud respeta tu plan y los límites de velocidad.
Con el servidor Motomarks MCP, puedes:
- Buscar e inspeccionar cualquier marca de automóviles publicada: nombres, slugs, descripciones, colores, paletas, enlaces sociales y datos de la empresa.
- Explorar activos de logotipos por marca: logotipos completos, insignias y marcas denominativas en webp, png y svg en cinco tamaños.
- Generar URL de imágenes CDN autenticadas con tu clave publicable, listas para pegar en HTML, React o Markdown.
- Verificar tu cuenta: plan, estado de atribución y uso de API de hoy.
Configuración en un clic
| Añadir a Cursor | Añadir a VS Code |
|---|---|
| Consulta logotipos de marcas directamente desde tu código. | Busca marcas e incrusta logotipos mediante GitHub Copilot. |
Endpoint
https://motomarks.io/api/mcp
Transporte: HTTP transmisible. En la primera conexión, tu cliente ejecuta un flujo OAuth basado en navegador (registro dinámico de cliente + PKCE) contra tu cuenta de Motomarks. No se requiere edición de JSON ni manejo manual de tokens.
Clientes compatibles
| Cliente | Configuración |
|---|---|
| Claude (Claude.ai, Desktop, Code) | Añade un conector personalizado con la URL del endpoint, o usa claude mcp add --transport http motomarks https://motomarks.io/api/mcp |
| Cursor | Instalación en un clic arriba, o añade la URL en Configuración → MCP |
| VS Code (GitHub Copilot) | Instalación en un clic arriba, o "motomarks": { "type": "http", "url": "https://motomarks.io/api/mcp" } en mcp.json |
| Google Gemini CLI | gemini extensions install con este repositorio, o añade el httpUrl a settings.json |
| Cualquier cliente solo stdio | Conéctate a través del proxy mcp-remote (abajo) |
Proxy local (clientes stdio)
Para clientes que solo hablan stdio, conéctate a través de mcp-remote:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://motomarks.io/api/mcp"]
}
}
}
Requiere Node.js 20+. El proxy abre un navegador para el inicio de sesión OAuth y almacena tokens en caché localmente.
Autenticación sin interfaz / con clave API
Para CI, backends o configuraciones no interactivas, autentícate con una clave API secreta de Motomarks (sk_..., creada en tu panel de control) en lugar de OAuth, enviándola como token Bearer:
Authorization: Bearer sk_...
Con el proxy local:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://motomarks.io/api/mcp",
"--header",
"Authorization: Bearer sk_..."
]
}
}
}
Herramientas compatibles
| Herramienta | Intención | Descripción |
|---|---|---|
search_brands | lectura | Busca marcas publicadas por nombre, empresa o slug; opcionalmente incluye URL de imágenes CDN |
get_brand | lectura | Detalle completo de la marca: descripción, colores, paleta, enlaces sociales, datos de la empresa, preguntas frecuentes |
list_brand_assets | lectura | Activos de logotipos disponibles (tipo, formato, tamaño, aspecto, dimensiones) con URL CDN |
build_image_url | lectura | URL de imagen CDN determinista usando tu clave publicable |
describe_api_endpoint | lectura | Referencia HTTP para las operaciones REST API sin procesar |
get_account | lectura | Tu plan, estado de atribución y uso de hoy frente al límite |
Recursos: motomarks://docs/image-cdn, motomarks://docs/api-v1, motomarks://brand/{slug}.
Indicaciones: find_brand_logo, embed_brand_image.
Flujos de trabajo de ejemplo
- "Añade el logotipo de la insignia de BMW a esta tabla de precios."
- "¿Cuáles son los colores de marca de Lamborghini? Dame la paleta completa."
- "Enumera todos los activos de marca denominativa de Toyota y elige el mejor para una barra de navegación oscura."
- "¿Cuántas solicitudes de API me quedan hoy?"
Datos y seguridad
- Todo el tráfico está cifrado en tránsito mediante HTTPS.
- OAuth 2.1 (PKCE, registro dinámico de cliente) o claves API con alcance controlan el acceso.
- Las herramientas respetan tu plan de Motomarks, los requisitos de atribución y los límites de velocidad.
- Las claves secretas nunca se devuelven a través de las herramientas; la salida de la cuenta las enmascara.
Los clientes MCP pueden actuar en tu nombre. Usa solo clientes de confianza, prefiere el menor privilegio y revisa tus aplicaciones conectadas en el panel de control de Motomarks. Consulta SECURITY.md para informar.
Publicación (mantenedores)
Este repositorio no contiene código de servidor: el servidor está alojado en https://motomarks.io/api/mcp. Publicar significa listar el endpoint en registros y directorios:
- Verifica el dominio
motomarks.iopara el espacio de nombres del registroio.motomarks(desafío DNS o HTTP), luego publica el manifiesto:mcp-publisher login dns --domain motomarks.io && mcp-publisher publishcon server.json. - Envía la entrada del registro / repositorio a los directorios MCP (Registro MCP oficial, mercado de Cursor, conectores de Claude, PulseMCP, Smithery, Glama).
Soporte
- Documentación: motomarks.io/docs/mcp
- Problemas: Problemas de GitHub
- Correo electrónico: support@motomarks.io