This website requires JavaScript to run properly.
Yoku

Jan Integration

Connect Jan AI to Yoku's MCP server for conversational brand intelligence.

Overview

Jan is an open-source ChatGPT alternative that runs entirely on your computer. By connecting Jan to Yoku's MCP server, you can query brand data conversationally while maintaining privacy and control.

What you can do:

  • Ask Jan about any company's brand identity
  • Search for brands by industry or location
  • Get brand colors, logos, and company details through conversation
  • Build brand-aware applications with Jan's API

Prerequisites

Before you begin, ensure you have:

Step-by-Step Configuration

Step 1: Open Jan Settings

  1. Launch Jan on your computer
  2. Click the Settings icon (⚙️) in the bottom left corner
  3. Navigate to "Extensions" or "Advanced Settings"

Step 2: Access MCP Server Configuration

In Jan's settings:

  1. Look for the "Model Context Protocol" or "MCP Servers" section
  2. Click "Add Server" or "Configure MCP"

If Jan doesn't have a UI for MCP configuration yet, you'll need to edit the configuration file directly:

macOS/Linux:

~/.jan/settings/mcp-servers.json

Windows:

%USERPROFILE%\.jan\settings\mcp-servers.json

Step 3: Add Yoku MCP Server

Create or edit the MCP servers configuration file with the following content:

{
  "mcpServers": {
    "Yoku": {
      "active": true,
      "args": [],
      "command": "",
      "env": {},
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      },
      "type": "http",
      "description": "Yoku Brand Intelligence API",
      "url": "https://mcp.yoku.app"
    }
  }
}

Replace YOUR_API_KEY_HERE with your actual API key!

Get your API key from dashboard settings.

Using Yoku with Jan

Natural Language Queries

Jan makes it easy to query brand data through conversation:

Getting Brand Information:

You: "What are Netflix's brand colors?"
Jan: [Uses brand.get] Netflix's primary brand color is #E50914 (red)...

You: "Tell me about Spotify's brand identity"
Jan: [Uses brand.get] Spotify is a music streaming service...

You: "Get logo and colors for Apple"
Jan: [Uses brand.get] Here's Apple's brand information...

Searching for Brands:

You: "Find fintech companies"
Jan: [Uses brand.search] Here are some fintech companies...

You: "Search for German tech brands"
Jan: [Uses brand.search with country filter] Found these German brands...

You: "Show me companies similar to Stripe"
Jan: [Uses brand.search] Here are payment processing companies...

Complex Queries:

You: "Compare the brand colors of Spotify and Apple Music"
Jan: [Uses brand.get twice] Let me get both brands' colors...
     Spotify: #1DB954 (green), #191414 (black)
     Apple Music: #FA2D5B (pink), #000000 (black)

You: "List the top 5 e-commerce brands and their primary colors"
Jan: [Uses brand.search then brand.get] Here are the results...

Example Conversations

Example 1: Research a Company

You: "I'm building a competitor analysis. Get me details about Stripe."

Jan: I'll fetch that information using Yoku.
     [Calls brand.get with domain: "stripe.com"]

     Stripe is a payment processing platform...
     - Website: stripe.com
     - Industry: Financial Technology
     - Primary Color: #635BFF (purple)
     - Description: Stripe is a technology company that builds...
     - Social: @stripe on Twitter, /stripe on LinkedIn

Example 2: Generate Brand-Aware Content

You: "Get Netflix's brand colors and write a promotional paragraph using their brand voice."

Jan: [Calls brand.get for netflix.com]
     Netflix's brand colors are:
     - Primary: #E50914 (red)
     - Secondary: #000000 (black)

     Here's a promotional paragraph:
     "Experience unlimited entertainment with Netflix..."

Example 3: Enrich Your Dataset

You: "I have a list of companies: Spotify, Netflix, and Uber. Get their logos and primary colors."

Jan: [Calls brand.get for each company]

     1. Spotify
        - Logo: [URL to CDN]
        - Primary: #1DB954 (green)

     2. Netflix
        - Logo: [URL to CDN]
        - Primary: #E50914 (red)

     3. Uber
        - Logo: [URL to CDN]
        - Primary: #000000 (black)

Troubleshooting

MCP Server Not Connecting

Problem: Jan can't connect to Yoku's MCP server

Solutions:

  1. Verify your API key is correct
  2. Check your internet connection
  3. Ensure the configuration file is valid JSON
  4. Restart Jan completely
  5. Check Jan's logs for error messages (usually in ~/.jan/logs/)

"Unauthorized" Error

Problem: Getting 401 Unauthorized errors

Solutions:

  1. Double-check your API key from dashboard settings
  2. Ensure you're using the Bearer prefix
  3. Verify your API key hasn't been revoked
  4. Remove any extra spaces or quotes around the API key

Tools Not Available

Problem: Jan doesn't recognize Yoku tools

Solutions:

  1. Verify the MCP server is properly configured
  2. Restart Jan after configuration changes
  3. Try explicitly asking: "Use the Yoku MCP server to..."
  4. Check if Jan has MCP enabled in its settings

Slow Responses

Problem: Queries take a long time

Solutions:

  1. Check your network connection
  2. Verify you're not hitting rate limits (check dashboard)
  3. Increase the timeout setting in your configuration
  4. Try with simpler queries first

Configuration File Not Found

Problem: Can't find the MCP configuration file

Solutions:

  1. Create the directory if it doesn't exist: 
    mkdir -p ~/.jan/settings
  2. Create the file manually: 
    touch ~/.jan/settings/mcp-servers.json
  3. Check Jan's documentation for the correct path
  4. Look in Jan's settings UI for configuration options

Advanced Usage

Custom Prompts with Yoku Data

You can create custom prompts that leverage Yoku's brand data:

Prompt Template:

You are a brand analyst. When I mention a company:
1. Use Yoku's brand.get tool to fetch their data
2. Analyze their brand positioning
3. Suggest improvements based on industry trends

Now analyze: [Company Name]

Batch Processing

Process multiple brands in one conversation:

You: "Get brand information for the following companies and create a comparison table: Stripe, Square, PayPal, Adyen"

Jan: [Calls brand.get for each company, then creates table]
     Here's the comparison...

Integration with Jan's API

If you're using Jan programmatically, you can access Yoku's MCP tools via Jan's API:

const response = await jan.chat({
  message: "Use Yoku to get brand data for stripe.com",
  tools: ["yoku.brand.get"],
});

Performance Tips

1. Be Specific in Queries

Instead of: "Tell me about tech companies" Try: "Search for fintech companies using Yoku"

2. Use Filters When Searching

Leverage the brand.search parameters:

"Search for brands in Germany with limit 5"
"Find companies in the US matching 'payment'"

3. Cache Frequently Used Data

For brands you query often, save the results in your conversation context:

"Save Netflix's brand colors for this session"

4. Combine Multiple Queries

Instead of separate queries, combine them:

"Get brand data for Spotify and Apple Music, then compare their color palettes"

Use Cases with Jan

Content Writing

"Use Yoku to get Airbnb's brand voice, then write a product description in that style"

Design Reference

"Get the brand colors for 5 top SaaS companies and create a color palette inspiration board"

Market Research

"Search for e-commerce brands in France, get details on the top 3, and summarize their positioning"

Data Enrichment

"I have this list of domains: [list]. Get brand information for each and format as JSON"

Next Steps

Need Help?

Having trouble with Jan integration?

Note: Jan's MCP Support

Jan's MCP implementation may vary by version. If the configuration steps above don't work, consult Jan's official documentation for the latest MCP setup instructions, then adapt the Yoku server details accordingly.

Pro Tip: Create Custom Commands

Set up Jan shortcuts or custom commands to quickly access Yoku data. For example, create a "/brand domain" command that automatically calls brand.get.

Cursor Integration

Configure Cursor to use Yoku's MCP server for AI-assisted development.

Tools Reference

Complete API reference for Yoku's MCP tools.