Yoku MCP Server

Yoku MCP Server provides brand intelligence tools for AI assistants through the Model Context Protocol (MCP). This server enables AI assistants like Claude to retrieve comprehensive brand data including logos, colors, social profiles, and more.

Features

• Brand Retrieval: Get detailed brand information by domain, name, ticker, or ISIN
• Brand Search: Fuzzy search for brands with autocomplete support
• Rich Data: Access logos, colors, social profiles, ratings, and more
• Easy Integration: Works with Claude Desktop, Cursor, and other MCP clients

Installation

Prerequisites

• Node.js 18 or higher
• A Yoku API key (get one at yoku.app/dashboard)

Install via npm

npm install -g @yokuapp/mcp-server

Install from source

git clone https://github.com/yokuapp/mcp-server.git
cd mcp-server
npm install
npm run build

Configuration

Create a .env file in your project directory or set environment variables:

# Required
YOKU_API_KEY=your_api_key_here

# Optional (these are the defaults)
YOKU_API_BASE_URL=https://api.yoku.app
YOKU_CDN_BASE_URL=https://cdn.yoku.app
YOKU_REQUEST_TIMEOUT=30000

Usage

With Claude Desktop

Add the server to your Claude Desktop configuration:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "yoku": {
      "command": "npx",
      "args": ["-y", "@yokuapp/mcp-server"],
      "env": {
        "YOKU_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "yoku": {
      "command": "node",
      "args": ["/path/to/mcp-server/build/index.js"],
      "env": {
        "YOKU_API_KEY": "your_api_key_here"
      }
    }
  }
}

With Cursor

Add to your Cursor MCP settings (if supported).

Direct Usage

You can also run the server directly:

YOKU_API_KEY=your_key node build/index.js

Available Tools

brand.get

Retrieve comprehensive brand information by domain, name, ticker, or ISIN.

Parameters:

• domain (optional): Brand domain (e.g., "nike.com")
• name (optional): Brand or company name (e.g., "Nike")
• ticker (optional): Stock ticker symbol (e.g., "NKE")
• isin (optional): International Securities Identification Number

Example:

Get brand information for nike.com

Response includes:

• Basic information (title, description, slogan)
• Contact details (email, phone, website)
• Brand assets (logos, icons) with CDN URLs
• Color palette with hex values
• Social media profiles
• Ratings and reviews
• Industry classification
• And more...

brand.search

Search for brands using fuzzy matching for discovery and autocomplete.

Parameters:

• q (required): Search query (1-255 characters)
• limit (optional): Maximum results to return (1-100, default: 10)
• offset (optional): Number of results to skip (default: 0)
• country (optional): Two-letter country code filter (e.g., "US", "FR")

Example:

Search for brands matching "nike"

Response includes:

• Total count of matches
• Array of matching brands with relevance scoring

Example Conversations

Once configured, you can ask Claude:

• "Get the brand information for nike.com"
• "Search for coffee brands in France"
• "Find the logo and colors for stripe.com"
• "Look up the company with ticker AAPL"
• "Search for brands similar to shopify"

Development

Build

npm run build

Project Structure

src/
├── index.ts        # Main MCP server
├── config.ts       # Configuration management
└── api-client.ts   # Yoku API client

Troubleshooting

"Missing required environment variable: YOKU_API_KEY"

Make sure you've set the YOKU_API_KEY environment variable or created a .env file.

"API request failed with status 401"

Your API key is invalid or expired. Get a new one from yoku.app/dashboard.

"API request failed with status 429"

You've exceeded your API rate limit. Check your plan limits or wait for the rate limit to reset.

Support

• Documentation: docs.yoku.app
• API Reference: api.yoku.app/v1/docs
• Issues: github.com/yokuapp/mcp-server/issues
• Email: [email protected]

License

ISC

About Yoku

Yoku is a developer-first platform that provides structured, real-time brand identity and company data through a simple API. Get comprehensive brand information including logos, colors, social profiles, ratings, and more.

Visit yoku.app to learn more.