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

Requirements

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

hljs language-bash

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

Or with Homebrew:

hljs language-bash

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).

AI agent install (recommended)

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

hljs language-text

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

Manual quick install

MCP server installation

Run in terminal:
hljs language-bash
```
uvx yutori-mcp login
```
This will open Yutori Platform in your browser and save your API key locally.
Or, manually add your API key

Go to (https://platform.yutori.com) and add your key to the config file:
hljs language-bash
```
mkdir -p ~/.yutori
cat > ~/.yutori/config.json << 'EOF'
{"api_key": "yt-your-api-key"}
EOF
```
Install MCP using add-mcp (requires Node.js):
hljs language-csharp
```
npx add-mcp "uvx yutori-mcp"
```
Pick the clients you want to configure.
Install workflow skills using skills.sh (requires Node.js):
hljs language-bash
```
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.
To list or remove skills later:
hljs language-bash
```
npx skills ls -g
npx skills remove -g yutori-login
```
Restart the tool you are using.

Manual per-client install

Claude Code

Plugin (Recommended) - Includes MCP tools + workflow skills

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

hljs language-bash

/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:
hljs language-bash
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:

hljs language-sql

/plugin uninstall yutori@yutori-plugins -s user

MCP Only (if you prefer not to use the plugin)
hljs language-bash
```
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).

Claude Desktop

Add to your claude_desktop_config.json:

hljs language-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.

Cursor

Click the button to install:

Or install manually:

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

hljs language-json

{
  "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.

VS Code

Click the button to install:

Or install manually:

hljs language-bash

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

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

ChatGPT

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

hljs language-json

{
  "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.

Codex

MCP Server:
hljs language-bash
```
codex mcp add yutori -- uvx yutori-mcp
```
Or add to ~/.codex/config.toml:
hljs language-toml
```
[mcp_servers.yutori]
command = "uvx"
args = ["yutori-mcp"]
```
The server reads your API key from ~/.yutori/config.json.

Skills (optional, for workflow guidance):

Install skills using $skill-installer inside Codex:

hljs language-bash

$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):

hljs language-bash

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.

OpenClaw

Follow the Quickstart above:

Install skills and MCP for OpenClaw (and optionally other tools) via skills.sh:
hljs language-bash
```
npx skills add yutori-ai/yutori-mcp
```
When prompted, choose which Yutori skills to install and select OpenClaw as the tool.

Gemini CLI

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

hljs language-json

{
  "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.

Run with pip

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

hljs language-bash

pip install yutori-mcp

Tools

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

Development

Setup

hljs language-bash

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

Testing

hljs language-bash

pytest

Running locally

hljs language-bash

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

Targeting the dev environment

The server hits the production API (https://api.yutori.com/v1) by default. For testing, point it at the dev stack (https://api.dev.yutori.com/v1) with the --env flag or the YUTORI_ENV environment variable (the flag wins if both are set):

hljs language-bash

yutori-mcp --env dev

Or in an MCP client config:

hljs language-json

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

Setting "env": {"YUTORI_ENV": "dev"} in the server config works too. An unknown environment name fails at startup rather than silently falling back to production. Note that the login/logout/status auth subcommands always talk to production; use a YUTORI_API_KEY valid for dev when targeting it.

Debugging with MCP Inspector

hljs language-bash

npx @modelcontextprotocol/inspector yutori-mcp

API Documentation

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

License

Apache 2.0

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

Requirements

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

hljs language-bash

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

Or with Homebrew:

hljs language-bash

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).

AI agent install (recommended)

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

hljs language-text

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

Manual quick install

MCP server installation

Run in terminal:
hljs language-bash
```
uvx yutori-mcp login
```
This will open Yutori Platform in your browser and save your API key locally.
Or, manually add your API key

Go to (https://platform.yutori.com) and add your key to the config file:
hljs language-bash
```
mkdir -p ~/.yutori
cat > ~/.yutori/config.json << 'EOF'
{"api_key": "yt-your-api-key"}
EOF
```
Install MCP using add-mcp (requires Node.js):
hljs language-csharp
```
npx add-mcp "uvx yutori-mcp"
```
Pick the clients you want to configure.
Install workflow skills using skills.sh (requires Node.js):
hljs language-bash
```
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.
To list or remove skills later:
hljs language-bash
```
npx skills ls -g
npx skills remove -g yutori-login
```
Restart the tool you are using.

Manual per-client install

Claude Code

Plugin (Recommended) - Includes MCP tools + workflow skills

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

hljs language-bash

/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:
hljs language-bash
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:

hljs language-sql

/plugin uninstall yutori@yutori-plugins -s user

MCP Only (if you prefer not to use the plugin)
hljs language-bash
```
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).

Claude Desktop

Add to your claude_desktop_config.json:

hljs language-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.

Cursor

Click the button to install:

Or install manually:

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

hljs language-json

{
  "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.

VS Code

Click the button to install:

Or install manually:

hljs language-bash

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

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

ChatGPT

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

hljs language-json

{
  "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.

Codex

MCP Server:
hljs language-bash
```
codex mcp add yutori -- uvx yutori-mcp
```
Or add to ~/.codex/config.toml:
hljs language-toml
```
[mcp_servers.yutori]
command = "uvx"
args = ["yutori-mcp"]
```
The server reads your API key from ~/.yutori/config.json.

Skills (optional, for workflow guidance):

Install skills using $skill-installer inside Codex:

hljs language-bash

$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):

hljs language-bash

git clone https://github.com/yutori-ai/yutori-mcp /tmp/yutori-mcp
cp -rL /tmp/yutori-mcp/.agents/skills/* ~/.agents/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.

OpenClaw

Follow the Quickstart above:

Install skills and MCP for OpenClaw (and optionally other tools) via skills.sh:
hljs language-bash
```
npx skills add yutori-ai/yutori-mcp
```
When prompted, choose which Yutori skills to install and select OpenClaw as the tool.

Gemini CLI

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

hljs language-json

{
  "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.

Run with pip

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

hljs language-bash

pip install yutori-mcp

Tools

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

Development

Setup

hljs language-bash

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

Testing

hljs language-bash

pytest

Running locally

hljs language-bash

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

Targeting the dev environment

hljs language-bash

yutori-mcp --env dev

Or in an MCP client config:

hljs language-json

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

Debugging with MCP Inspector

hljs language-bash

npx @modelcontextprotocol/inspector yutori-mcp

API Documentation

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

License

Apache 2.0

yutori-mcp

Yutori MCP

Features

Installation

AI agent install (recommended)

Manual quick install

Manual per-client install

Tools

Development

Setup

Testing

Running locally

Targeting the dev environment

Debugging with MCP Inspector

API Documentation

License

Similar Packages

yutori-mcp

Yutori MCP

Features

Installation

AI agent install (recommended)

Manual quick install

Manual per-client install

Tools

Development

Setup

Testing

Running locally

Targeting the dev environment

Debugging with MCP Inspector

API Documentation

License

Similar Packages