# Yandex — how to use (mcp.ai)

Yandex is a Russian internet services provider offering search, email, navigation, and other web-based solutions, often referred to as “Russia’s Google”

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_yandex?ms=1781542500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `yandex_organization_search`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/yandex`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/yandex/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/yandex/organization/search` — Tool to find businesses and organizations by name, address, or tin. use when you need to search for companies in a specific region or text query.
  - body: { ll?: string, spn?: string, uri?: string, bbox?: string, lang: string, rspn?: boolean, skip?: integer, text: string, type?: string, apikey: string, results?: integer }
- `POST https://api.mcp.ai/api/yandex/yandex/geocoder/reverse` — Tool to perform reverse geocoding using yandex maps http geocoder api.
  - body: { kind?: string, lang?: string, apikey: string, format?: string, latitude: number, longitude: number }
- `POST https://api.mcp.ai/api/yandex/yandex/route` — Tool to generate detailed route for driving, walking, or public transport. use when planning a route between specified geographic points.
  - body: { mode?: string, width?: number, apikey: string, height?: number, length?: number, levels?: string, weight?: number, payload?: number, traffic?: string, eco_class?: integer, waypoints: string, max_weight?: number, avoid_tolls?: boolean, avoid_zones?: string[], axle_weight?: number, has_trailer?: boolean, departure_time?: integer }
- `POST https://api.mcp.ai/api/yandex/yandex/tiles` — Tool to fetch individual map tile images by x/y coordinates and zoom level. use after calculating tile indices for custom map rendering.
  - body: { l: string, x: integer, y: integer, z: integer, lang: string, scale?: number, apikey: string, maptype?: string, projection?: string }

## More
- Page: https://mcp.ai/yandex
- Agent spec (llms.txt): https://mcp.ai/yandex/llms.txt
- Postman collection: https://mcp.ai/yandex/postman.json