Logo.dev MCP Server

An MCP (Model Context Protocol) server for the Logo.dev API that enables searching for and retrieving company logos. Ready for deployment on Smithery.

Features

• Search for logos: Search for company logos by brand or company name
• Get logo URLs: Retrieve direct logo image URLs with customization options
• Multiple formats: Support for PNG, JPG, and WebP formats
• Theme variants: Light and dark theme options
• Customizable: Size, format, theme, and greyscale options
• Smithery Ready: Deploy directly to Smithery with automatic configuration

Tools

search_logos

Search for company logos by brand name or company name.

Parameters:

• query (string, required): The brand or company name to search for

Returns: A list of matching companies with their domains and logo URLs.

Example:

{
  "query": "Google",
  "count": 1,
  "results": [
    {
      "name": "Google",
      "domain": "google.com",
      "logoUrl": "https://img.logo.dev/google.com?token=..."
    }
  ]
}

get_logo_url

Get a direct logo image URL for a specific domain with customization options.

Parameters:

• domain (string, required): The company domain (e.g., 'google.com')
• size (string, optional): Logo size/dimensions
• format (string, optional): Image format - "png", "jpg", or "webp" (default: png)
• theme (string, optional): Logo theme - "light" or "dark"
• greyscale (boolean, optional): Convert logo to greyscale (default: false)

Returns: Logo URL with the specified options.

Example:

{
  "domain": "apple.com",
  "logoUrl": "https://img.logo.dev/apple.com?token=...&format=webp&theme=dark",
  "options": {
    "size": "default",
    "format": "webp",
    "theme": "dark",
    "greyscale": false
  }
}

Smithery Deployment

This server is designed for Smithery deployment:

1. Push this code to a Git repository
2. Connect the repository to Smithery
3. Smithery will automatically detect the TypeScript runtime
4. Enter your Logo.dev API key when prompted
5. Deploy and use!

Local Usage

Prerequisites

• Node.js 20 or higher
• A Logo.dev API key (get one at logo.dev)

Installation

npm install
npm run build

STDIO Mode (for Claude Desktop)

export LOGO_DEV_API_KEY="your-api-key-here"
node build/index.js

Claude Desktop Configuration

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "logo-dev": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-logo-dev/build/index.js"],
      "env": {
        "LOGO_DEV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Development

Watch mode

npm run watch

Testing with MCP Inspector

npm run inspector

API Reference

This server uses the Logo.dev API:

• Search endpoint: https://api.logo.dev/search?q={query}
• Image CDN: https://img.logo.dev/{domain}

License

MIT