SkillFoxx

Yandex image search MCP

mcp-yandex-search-api

A Python MCP server for searching Yandex Images through the Yandex Search API

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs a Python server via uv that searches images through Yandex Search API
  • Needs a Yandex Cloud service account key or IAM token
All reasons and checks
Russian stack

gennadynemchin/mcp-yandex-search-apiAuthor:Gennadynemchin

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mcp-yandex-search-api

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a Python server via uv that searches images through Yandex Search API
  • Needs a Yandex Cloud service account key or IAM token

This is third-party code. Review the repository files before installing.

What it does

The server offers one tool, search_images, which searches Yandex Images by text query and supports every Yandex Search API parameter: search type, family filter, typo correction, format, size, orientation, color, site restriction, user agent, page number and results per page. The XML API response is automatically parsed into JSON with links to the original image, thumbnail and source page, or raw XML can be requested with the return_raw_xml parameter. Auth uses a service account API key or an IAM token.

Who it is for. For people who need agentic image search specifically in the Yandex index rather than Google or Bing.

Good fit when

  • You need to find images on a topic with size, color or orientation filters
  • You need image search limited to a specific site
  • You work in VS Code, Cursor or another MCP client and want ready XML-to-JSON parsing

Not a fit when

  • You need text web search rather than image search: the server only offers search_images
  • You have no Yandex Cloud billing account with the search-api.webSearch.user role

Example request

Find large color images of a Christmas tree decorated in an urban style

MCP

Transport
stdio
Authentication
key is optional

Environment variables

YANDEX_FOLDER_ID required
Yandex Cloud folder ID
YANDEX_API_KEY secret
Service account API key, the recommended method
YANDEX_IAM_TOKEN secret
IAM token as an alternative to the API key

Limitations

Image search only; the server does not offer web search or other Yandex search types. Requires a Yandex Cloud service account with the search-api.webSearch.user role and an API key scoped to yc.search-api.execute. Requires Python 3.10 and the uv package manager.

How to disable. Remove the yandex-search-api block from your MCP client config.

FAQ

Can it search text instead of images?

No, the server only offers the search_images tool for searching Yandex Images.

Can I get the raw API response instead of JSON?

Yes, the return_raw_xml=true parameter returns the raw Yandex Search API XML response.

How is this MCP different from other Yandex Search API servers?

The Python server gives one tool, search_images: image search by text query in the Yandex Images index. All Yandex Search API parameters are supported: search type, family filter and query correction.

Can I search text instead of images and get the raw API response?

This server searches images only. For web search use a Yandex Search API server with web tools. The output format is described in the README. Install with git clone and uv, it works in VS Code and Cursor.

Discussion

No questions or reviews yet.

All Yandex Search tools
Russian stack

A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes

MCP serverExtended access4
Official

Yandex's official MCP server for web search via Yandex Search API: results with sources and a generative answer

MCP serverExtended access47
Russian stack

An MCP web-search and content-extraction server via Yandex and Google on top of SerpAPI, geared toward RU/CIS results

MCP serverExtended access1

Yandex Search.API MCP with Wordstat

Yandex Search.API MCP Server

Russian stack

An MCP server for Yandex's official Search.API: web, image, generative search and four Wordstat tools in one npm package

MCP serverExtended access1

README in short

The README describes the single search_images tool with all API parameters, Python and uv requirements, setting up a service account with the right role, an environment variable table, local run instructions, debugging via MCP Inspector, and connecting to VS Code and Cursor with config examples and the response structure.

README badge

Report a problem