Yutori MCP

MCP tools and skills for web monitoring, deep research, and browser automation — powered by Yutori's web agentic tech.

You can use it with Claude Code, Codex, Cursor, VS Code, ChatGPT, OpenClaw, and other MCP hosts.

Features

Capabilities:

• Scouting — Monitor the web continuously for anything you care about at a desired frequency
• Research — Run one-time deep web research tasks
• Browsing — Automate websites with an AI navigator

Workflow skills (for clients that support slash commands):

• /yutori-scout — Set up continuous web monitoring
• /yutori-research — Deep web research (async, 5–10 min)
• /yutori-browse — Browser automation
• /yutori-competitor-watch — Competitor monitoring template
• /yutori-api-monitor — API/changelog monitoring template

Installation

<details> <summary>Requirements</summary>

If you don't already have uv installed, install it (it includes uvx):

curl -LsSf https://astral.sh/uv/install.sh | sh

Or with Homebrew:

brew install uv

Python 3.10 or higher is required (uv manages this automatically for most installs).

For the quickstart below, Node.js is also required (for npx). </details>

AI agent install (recommended)

Paste this into Claude Code, Codex, Cursor, Windsurf, or another coding agent:

Use https://yutori.com/api/llms.txt and set up Yutori for me.

Manual quick install

1. Run in terminal:

   uvx yutori-mcp login
   

   This will open Yutori Platform in your browser and save your API key locally.

   <details> <summary>Or, manually add your API key</summary>

   Go to (https://platform.yutori.com) and add your key to the config file:

   mkdir -p ~/.yutori
   cat > ~/.yutori/config.json << 'EOF'
   {"api_key": "yt-your-api-key"}
   EOF
   

   </details>

2. Install MCP using add-mcp (requires Node.js):

   npx add-mcp "uvx yutori-mcp"
   

   Pick the clients you want to configure.

3. Install workflow skills using skills.sh (requires Node.js):

   npx skills add yutori-ai/yutori-mcp -g
   

   Adds slash-command shortcuts like /yutori-scout, /yutori-research, and more.

   -g installs them at user scope. Omit -g if you want a project-local install instead.

   <details> <summary>To list or remove skills later:</summary>

   npx skills ls -g
   npx skills remove -g yutori-login
   

   </details>

4. Restart the tool you are using.

Manual per-client install

<details> <summary>Claude Code</summary>

1. Plugin (Recommended) - Includes MCP tools + workflow skills

   Type these commands in Claude Code's input (not in a terminal):

   /plugin marketplace add yutori-ai/yutori-mcp
   /plugin install yutori@yutori-plugins
   

   This installs both the MCP tools and workflow skills:

   Skill	Description
   /yutori-scout	Set up continuous web monitoring with comprehensive queries
   /yutori-research	Deep web research workflow (async, 5-10 min)
   /yutori-browse	Browser automation tasks
   /yutori-competitor-watch	Quick competitor monitoring template
   /yutori-api-monitor	API/changelog monitoring template

   Already have the MCP server installed? Remove it first to avoid duplicate configurations:

   claude mcp remove yutori -s user   # if installed at user scope
   claude mcp remove yutori -s local  # if installed at local/project scope
   

   To uninstall the plugin later:

   /plugin uninstall yutori@yutori-plugins -s user
   

2. MCP Only (if you prefer not to use the plugin)

   claude mcp add --scope user yutori -- uvx yutori-mcp
   

   The server reads your API key from ~/.yutori/config.json (set up via uvx yutori-mcp login). </details>

<details> <summary>Claude Desktop</summary>

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "yutori": {
      "command": "uvx",
      "args": ["yutori-mcp"]
    }
  }
}

The server reads your API key from ~/.yutori/config.json.

For setup details, see the Claude Desktop MCP install guide. </details>

<details> <summary>Cursor</summary>

Click the button to install:

<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">

Or install manually:

Go to Cursor Settings → MCP → Add new MCP Server, then add:

{
  "mcpServers": {
    "yutori": {
      "command": "uvx",
      "args": ["yutori-mcp"]
    }
  }
}

The server reads your API key from ~/.yutori/config.json.

See the Cursor MCP guide for setup details. </details>

<details> <summary>VS Code</summary>

Click the button to install:

<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code"> <img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">

Or install manually:

code --add-mcp '{"name":"yutori","command":"uvx","args":["yutori-mcp"]}'

The server reads your API key from ~/.yutori/config.json. </details>

<details> <summary>ChatGPT</summary>

Open ChatGPT Desktop and go to Settings -> Connectors -> MCP Servers -> Add server.

{
  "mcpServers": {
    "yutori": {
      "command": "uvx",
      "args": ["yutori-mcp"]
    }
  }
}

The server reads your API key from ~/.yutori/config.json.

For setup details, see the OpenAI MCP guide. </details>

<details> <summary>Codex</summary>

1. MCP Server:

   codex mcp add yutori -- uvx yutori-mcp
   

   Or add to ~/.codex/config.toml:

   [mcp_servers.yutori]
   command = "uvx"
   args = ["yutori-mcp"]
   

   The server reads your API key from ~/.yutori/config.json.

2. Skills (optional, for workflow guidance):

   Install skills using $skill-installer inside Codex:

   $skill-installer install https://github.com/yutori-ai/yutori-mcp/tree/main/.agents/skills/yutori-scout
   $skill-installer install https://github.com/yutori-ai/yutori-mcp/tree/main/.agents/skills/yutori-research
   $skill-installer install https://github.com/yutori-ai/yutori-mcp/tree/main/.agents/skills/yutori-browse
   $skill-installer install https://github.com/yutori-ai/yutori-mcp/tree/main/.agents/skills/yutori-competitor-watch
   $skill-installer install https://github.com/yutori-ai/yutori-mcp/tree/main/.agents/skills/yutori-api-monitor
   

   Or manually copy skills to your user directory (use -L so symlinks are dereferenced and real files are copied):

   git clone https://github.com/yutori-ai/yutori-mcp /tmp/yutori-mcp
   cp -rL /tmp/yutori-mcp/.agents/skills/* ~/.agents/skills/
   

   To uninstall manually copied skills, delete the matching directories from ~/.agents/skills/. When updating this way, remove old Yutori skill directories first, since cp -rL will not delete renamed or removed skills.

   Restart Codex after installing skills.

   Skill	Command	Description
   Scout	$yutori-scout	Set up continuous web monitoring
   Research	$yutori-research	Deep web research (async, 5-10 min)
   Browse	$yutori-browse	Browser automation with AI navigator
   Competitor Watch	$yutori-competitor-watch	Quick competitor monitoring template
   API Monitor	$yutori-api-monitor	API/changelog monitoring template

   See the Codex Skills docs for more on skills. </details>

<details> <summary>OpenClaw</summary>

Follow the Quickstart above:

1. Install skills and MCP for OpenClaw (and optionally other tools) via skills.sh:

   npx skills add yutori-ai/yutori-mcp
   

   When prompted, choose which Yutori skills to install and select OpenClaw as the tool.

</details>

<details> <summary>Gemini CLI</summary>

Add to ~/.gemini/settings.json. If you already have mcp or mcpServers, merge these keys into your existing config:

{
  "mcp": {
    "allowed": ["yutori"]
  },
  "mcpServers": {
    "yutori": {
      "command": "uvx",
      "args": ["yutori-mcp"]
    }
  }
}

The server reads your API key from ~/.yutori/config.json.

Add "yutori" to mcp.allowed if you already list other MCPs there. For more details, see the Gemini CLI MCP settings guide. </details>

<details> <summary>Run with pip</summary>

Install the package to run the MCP server (e.g. for custom or self-hosted setups):

pip install yutori-mcp

</details>

Tools

See TOOLS.md for the full tool reference — Scout, Research, and Browsing tools with parameters, examples, and response formats.

Development

Setup

git clone https://github.com/yutori-ai/yutori-mcp
cd yutori-mcp
pip install -e ".[dev]"

Testing

pytest

Running locally

yutori-mcp login    # authenticate (one-time)
yutori-mcp          # run the server (or: python -m yutori_mcp.server)

Debugging with MCP Inspector

npx @modelcontextprotocol/inspector yutori-mcp

API Documentation

For full API documentation, visit docs.yutori.com.

License

Apache 2.0