Motomarks MCP

Cada logotipo de carro, uma API simples

Documentação

Motomarks

Servidor Motomarks MCP

O servidor oficial do Model Context Protocol (MCP) para Motomarks: uma ponte hospedada na nuvem que dá às suas ferramentas de IA acesso seguro e em tempo real à API de logotipos de carros Motomarks e ao CDN de imagens.

Registro MCP: io.motomarks/mcp · Autenticação: OAuth 2.1 ou chave de API · Hospedagem: Motomarks Cloud

O Servidor Motomarks MCP conecta clientes compatíveis com MCP à biblioteca de marcas Motomarks. Uma vez configurado, suas ferramentas de IA podem pesquisar marcas automotivas, buscar dados de marcas e paletas de cores, navegar por ativos de logotipos e gerar URLs de imagens CDN prontas para incorporação. A autenticação usa OAuth 2.1 (login via navegador) ou uma chave de API secreta Motomarks, para que cada solicitação respeite seu plano e limites de taxa.

Com o Servidor Motomarks MCP, você pode:

  • Pesquisar e inspecionar qualquer marca de carro publicada: nomes, slugs, descrições, cores, paletas, links sociais e dados da empresa.
  • Navegar por ativos de logotipos por marca: logotipos completos, emblemas e wordmarks em webp, png e svg em cinco tamanhos.
  • Gerar URLs de imagens CDN autenticadas com sua chave publicável, prontas para colar em HTML, React ou Markdown.
  • Verificar sua conta: plano, status de atribuição e uso da API de hoje.

Configuração em um clique

Adicionar ao CursorAdicionar ao VS Code
Referencie logotipos de marcas diretamente do seu código.Pesquise marcas e incorpore logotipos via GitHub Copilot.

Endpoint

https://motomarks.io/api/mcp

Transporte: HTTP streamable. Na primeira conexão, seu cliente executa um fluxo OAuth baseado em navegador (registro dinâmico de cliente + PKCE) na sua conta Motomarks. Não é necessário editar JSON ou gerenciar tokens manualmente.

Clientes suportados

ClienteConfiguração
Claude (Claude.ai, Desktop, Code)Adicione um conector personalizado com a URL do endpoint, ou use claude mcp add --transport http motomarks https://motomarks.io/api/mcp
CursorInstalação em um clique acima, ou adicione a URL em Configurações → MCP
VS Code (GitHub Copilot)Instalação em um clique acima, ou "motomarks": { "type": "http", "url": "https://motomarks.io/api/mcp" } em mcp.json
Google Gemini CLIgemini extensions install com este repositório, ou adicione o httpUrl ao settings.json
Qualquer cliente somente stdioConecte-se através do proxy mcp-remote (abaixo)

Proxy local (clientes stdio)

Para clientes que falam apenas stdio, conecte-se através do mcp-remote:

{
  "mcpServers": {
    "motomarks": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://motomarks.io/api/mcp"]
    }
  }
}

Requer Node.js 20+. O proxy abre um navegador para login OAuth e armazena tokens em cache localmente.

Autenticação headless / chave de API

Para CI, backends ou configurações não interativas, autentique-se com uma chave de API secreta Motomarks (sk_..., criada no seu painel) em vez de OAuth, enviando-a como token Bearer:

Authorization: Bearer sk_...

Com o proxy local:

{
  "mcpServers": {
    "motomarks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://motomarks.io/api/mcp",
        "--header",
        "Authorization: Bearer sk_..."
      ]
    }
  }
}

Ferramentas suportadas

FerramentaIntençãoDescrição
search_brandsleituraPesquise marcas publicadas por nome, empresa ou slug; opcionalmente inclua URLs de imagens CDN
get_brandleituraDetalhes completos da marca: descrição, cores, paleta, links sociais, dados da empresa, FAQs
list_brand_assetsleituraAtivos de logotipo disponíveis (tipo, formato, tamanho, proporção, dimensões) com URLs CDN
build_image_urlleituraURL de imagem CDN determinística usando sua chave publicável
describe_api_endpointleituraReferência HTTP para as operações da API REST bruta
get_accountleituraSeu plano, status de atribuição e uso de hoje vs. limite

Recursos: motomarks://docs/image-cdn, motomarks://docs/api-v1, motomarks://brand/{slug}. Prompts: find_brand_logo, embed_brand_image.

Fluxos de trabalho de exemplo

  • "Adicione o logotipo do emblema BMW a esta tabela de preços."
  • "Quais são as cores da marca Lamborghini? Dê-me a paleta completa."
  • "Liste todos os ativos wordmark da Toyota e escolha o melhor para uma barra de navegação escura."
  • "Quantas solicitações de API ainda tenho hoje?"

Dados e segurança

  • Todo o tráfego é criptografado em trânsito via HTTPS.
  • OAuth 2.1 (PKCE, registro dinâmico de cliente) ou chaves de API com escopo controlam o acesso.
  • As ferramentas respeitam seu plano Motomarks, requisitos de atribuição e limites de taxa.
  • Chaves secretas nunca são ecoadas pelas ferramentas; a saída da conta as mascara.

Clientes MCP podem agir em seu nome. Use apenas clientes confiáveis, prefira o princípio do menor privilégio e revise seus aplicativos conectados no painel Motomarks. Consulte SECURITY.md para relatar problemas.

Publicação (mantenedores)

Este repositório não contém código de servidor — o servidor está hospedado em https://motomarks.io/api/mcp. Publicar significa listar o endpoint em registros e diretórios:

  1. Verifique o domínio motomarks.io para o namespace do registro io.motomarks (desafio DNS ou HTTP), depois publique o manifesto: mcp-publisher login dns --domain motomarks.io && mcp-publisher publish com server.json.
  2. Envie a entrada do registro / repositório para diretórios MCP (Registro MCP oficial, marketplace Cursor, conectores Claude, PulseMCP, Smithery, Glama).

Suporte