MCP Server

Give AI tools direct access to the Motomarks brand library. The hosted Model Context Protocol server lets Claude, Cursor, VS Code, and any MCP-compatible client search brands, read brand data, build logo CDN URLs, and create a free Motomarks account.

Endpoint

One hosted endpoint, streamable HTTP transport. New users can create a free account from the MCP session or in the browser OAuth window. No password or credit card.

MCP endpoint

https://motomarks.io/api/mcp

Setup

Add the endpoint to your client. You do not need an account first. On first use, either ask the agent to sign you up, or complete the browser window to create a free account and authorize access. Cursor and VS Code users can install in Cursor or install in VS Code with one click.

Claude Code

claude mcp add --transport http motomarks https://motomarks.io/api/mcp

Cursor · ~/.cursor/mcp.json

{
  "mcpServers": {
    "motomarks": {
      "url": "https://motomarks.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot) · mcp.json

{
  "servers": {
    "motomarks": {
      "type": "http",
      "url": "https://motomarks.io/api/mcp"
    }
  }
}

stdio-only clients (Claude Desktop, custom)

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

Authentication

The server implements the MCP authorization spec: OAuth 2.1 with dynamic client registration and PKCE. Your client can register itself and open a browser so you create an account or sign in once. Tokens refresh automatically. Clients that connect without OAuth can call sign_up instead.

New emails create a free account. Existing emails sign in with the same six-digit code.
Requests count toward your plan's daily rate limits; free-plan attribution requirements apply.
CDN image URLs returned by tools are signed with your publishable key. If your account has no API key yet, one named "MCP" is created automatically.
Revoke access anytime by revoking the API key in your dashboard.

Headless authentication

For CI, servers, or clients that cannot open a browser, authenticate with a secret API key from your dashboard instead of OAuth.

Remote (Bearer header)

Authorization: Bearer YOUR_SECRET_KEY

Local proxy

npx -y mcp-remote https://motomarks.io/api/mcp --header "Authorization: Bearer YOUR_SECRET_KEY"

Tools

Brand tools are read-only. Sign-up tools create a free account from the MCP session. Authenticated calls follow your plan and rate limits.

sign_up — email a six-digit code to create a free account or sign in. No password or credit card.
complete_sign_up — verify that code. New accounts receive API keys so the client can reconnect as that user.
search_brands — search published brands by name, company, or slug; optionally include ready-to-use CDN image URLs.
get_brand — full brand detail: description, colors, palette, social links, company facts, and FAQs.
list_brand_assets — available logo assets with type, format, size, aspect, dimensions, and CDN URLs.
build_image_url — deterministic image CDN URL authenticated with your publishable key.
describe_api_endpoint — HTTP reference for the raw REST API.
get_account — your plan, attribution status, and today's usage against the daily limit.

The server also exposes resources (motomarks://docs/image-cdn, motomarks://docs/api-v1, motomarks://brand/{slug}) and prompts (create_motomarks_account, find_brand_logo, embed_brand_image) for clients that support them.

Example prompts

Things to ask once the server is connected.

"Create a Motomarks account for me and then add the BMW badge logo."
"Add the BMW badge logo to this pricing table."
"What are Lamborghini's brand colors? Give me the full palette."
"List every Toyota wordmark and pick the best one for a dark navbar."
"How many API requests do I have left today?"

Registry manifests, client plugin files, and agent skills live in the motomarks/motomarks-mcp repository (MCP Registry name io.motomarks/mcp).