Logo

Logo MCP Server provides intelligent logo extraction from websites and detailed analysis of candidate logos. It combines multiple sourcing strategies, automatic quality scoring, and quick access to the best logo URL, helping you reliably identify brand marks for use in apps, marketing materials, or UI design.

How to use

You run the Logo MCP Server as an MCP (Model Context Protocol) server and query it through your MCP client. You can request the best logo URL for a site or ask for a full analysis that lists all logo candidates with their scores and details. Use the provided tools to fetch results and integrate the data into your workflows.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Install the Logo MCP package as a local dependency for your project or use it directly from your MCP client configuration.

npm install @lucianaib/logo-mcp

Configure your MCP client to load the Logo MCP server. Use the following configuration snippet in your MCP client setup to run the server via npx and the package name directly.

{
  "mcpServers": {
    "logo_mcp": {
      "command": "npx",
      "args": ["@lucianaib/logo-mcp"]
    }
  }
}

Additional notes

Development and testing can be done by installing the package and running the server in your environment. If you want to probe the available tools from your MCP client, you can use the two primary endpoints described here: get_best_logo_url to fetch the best logo URL, and analyze_logo to obtain full logo details including size, format, and quality.

Example usage from your MCP client to get the best logo URL for a site could resemble the following tool invocation.

{
  "name": "get_best_logo_url",
  "arguments": {
    "url": "https://www.google.com"
  }
}

To analyze a site's logos, requesting full details (not only the best URL):

{
  "name": "analyze_logo",
  "arguments": {
    "url": "https://www.github.com",
    "onlyBestUrl": false
  }
}

Available tools

get_best_logo_url

Fetches the best logo URL for a given website. Returns only the URL suitable for quick usage or display.

analyze_logo

Analyzes logos from a website, returning detailed information such as size, format, quality, and a list of candidates with scores. Supports optional onlyBestUrl to return just the best URL.