Motomarks MCP Server
The official Model Context Protocol (MCP) server for Motomarks: a cloud-hosted bridge that gives your AI tools secure, real-time access to the Motomarks car logo API and image CDN.
MCP Registry: io.motomarks/mcp · Auth: OAuth 2.1 or API key · Hosting: Motomarks Cloud
The Motomarks MCP Server connects MCP-compatible clients to the Motomarks brand library. Once configured, your AI tools can search automotive brands, fetch brand data and color palettes, browse logo assets, and generate ready-to-embed CDN image URLs. Authentication uses OAuth 2.1 (browser sign-in) or a Motomarks secret API key, so every request respects your plan and rate limits.
With the Motomarks MCP Server, you can:
- Search and inspect any published car brand: names, slugs, descriptions, colors, palettes, social links, and company facts.
- Browse logo assets per brand: full logos, badges, and wordmarks in webp, png, and svg across five sizes.
- Generate CDN image URLs authenticated with your publishable key, ready to paste into HTML, React, or Markdown.
- Check your account: plan, attribution status, and today's API usage.
One-click setup
Endpoint
https://motomarks.io/api/mcp
Transport: streamable HTTP. On first connection your client runs a browser-based OAuth flow (dynamic client registration + PKCE) against your Motomarks account. No JSON editing or manual token handling required.
Supported clients
| Client | Configuration |
|---|
| Claude (Claude.ai, Desktop, Code) | Add a custom connector with the endpoint URL, or use claude mcp add --transport http motomarks https://motomarks.io/api/mcp |
| Cursor | One-click install above, or add the URL under Settings → MCP |
| VS Code (GitHub Copilot) | One-click install above, or "motomarks": { "type": "http", "url": "https://motomarks.io/api/mcp" } in mcp.json |
| Google Gemini CLI | gemini extensions install with this repo, or add the httpUrl to settings.json |
| Any stdio-only client | Connect through the mcp-remote proxy (below) |
Local proxy (stdio clients)
For clients that only speak stdio, connect through mcp-remote:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://motomarks.io/api/mcp"]
}
}
}
Requires Node.js 20+. The proxy opens a browser for OAuth sign-in and caches tokens locally.
Headless / API key authentication
For CI, backends, or non-interactive setups, authenticate with a Motomarks secret API key (sk_..., created in your dashboard) instead of OAuth by sending it as a Bearer token:
Authorization: Bearer sk_...
With the local proxy:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://motomarks.io/api/mcp",
"--header",
"Authorization: Bearer sk_..."
]
}
}
}
| Tool | Intent | Description |
|---|
search_brands | read | Search published brands by name, company, or slug; optionally include CDN image URLs |
get_brand | read | Full brand detail: description, colors, palette, social links, company facts, FAQs |
list_brand_assets | read | Available logo assets (type, format, size, aspect, dimensions) with CDN URLs |
build_image_url | read | Deterministic CDN image URL using your publishable key |
describe_api_endpoint | read | HTTP reference for the raw REST API operations |
get_account | read | Your plan, attribution status, and today's usage vs. limit |
Resources: motomarks://docs/image-cdn, motomarks://docs/api-v1, motomarks://brand/{slug}.
Prompts: find_brand_logo, embed_brand_image.
Example workflows
- "Add the BMW badge logo to this pricing table."
- "What are Lamborghini's brand colors? Give me the full palette."
- "List every wordmark asset for Toyota and pick the best one for a dark navbar."
- "How many API requests do I have left today?"
Data and security
- All traffic is encrypted in transit over HTTPS.
- OAuth 2.1 (PKCE, dynamic client registration) or scoped API keys control access.
- Tools respect your Motomarks plan, attribution requirements, and rate limits.
- Secret keys are never echoed back by tools; account output masks them.
MCP clients can act on your behalf. Only use trusted clients, prefer least privilege, and review your connected apps in the Motomarks dashboard. See SECURITY.md for reporting.
Publishing (maintainers)
This repo contains no server code — the server is hosted at https://motomarks.io/api/mcp. Publishing means listing the endpoint in registries and directories:
- Verify the
motomarks.io domain for the io.motomarks registry namespace (DNS or HTTP challenge), then publish the manifest: mcp-publisher login dns --domain motomarks.io && mcp-publisher publish with server.json.
- Submit the registry entry / repo to MCP directories (official MCP Registry, Cursor marketplace, Claude connectors, PulseMCP, Smithery, Glama).
Support