{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yjjwk3hu27g3","handle":"yandex-iot-mcp","url":"https://wellknown.network/agents/yandex-iot-mcp","links":{"self":"https://wellknown.network/agents/yandex-iot-mcp/record.json","html":"https://wellknown.network/agents/yandex-iot-mcp","markdown":"https://wellknown.network/agents/yandex-iot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yandex-iot-mcp","status":"https://wellknown.network/api/v1/agents/yandex-iot-mcp/status","claim":"https://wellknown.network/agents/yandex-iot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yandex-iot-mcp/claim.json","badge":"https://wellknown.network/agents/yandex-iot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yandex-iot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yandex-iot-mcp","summary":"MCP server for the Yandex Smart Home (IoT) API: list and control devices, run scenarios, power-cycle smart sockets","description":"# yandex-iot-mcp\n\nMCP ([Model Context Protocol](https://modelcontextprotocol.io)) server for the\n[Yandex Smart Home IoT API](https://yandex.ru/dev/dialogs/smart-home/) ([API reference](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/platform-user-info)).\nLets AI assistants (Claude Code, Claude Desktop, and any other MCP client)\ninspect and control devices connected to Yandex Smart Home / Alice.\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `list_devices` | All devices with rooms, types, capabilities and sensor values |\n| `list_groups` | Device groups from the Yandex Home app |\n| `get_device` | Full state of one device, including online/offline |\n| `turn_on` / `turn_off` | On/off for sockets, lights, switches |\n| `power_cycle` | Off → wait N seconds → on. Hard-reset gear plugged into a smart socket |\n| `device_action` | Any capability action (range, mode, toggle, color_setting…) |\n| `list_scenarios` / `run_scenario` | Inspect and trigger scenarios |\n\n## Getting an OAuth token\n\n1. Create an app at [oauth.yandex.ru](https://oauth.yandex.ru): platform\n   **Web services**, redirect URI `https://oauth.yandex.ru/verification_code`.\n2. Grant it the **iot:view** and **iot:control** permissions (\"Умный дом\").\n3. Open\n   `https://oauth.yandex.ru/authorize?response_type=token&client_id=<CLIENT_ID>`\n   in a browser, authorize, and copy `access_token` from the address bar.\n\n## Usage\n\n### Claude Code\n\n```bash\nclaude mcp add yandex-iot --env YANDEX_IOT_TOKEN=<token> -- uvx yandex-iot-mcp\n```\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-iot\": {\n      \"command\": \"uvx\",\n      \"args\": [\"yandex-iot-mcp\"],\n      \"env\": { \"YANDEX_IOT_TOKEN\": \"<token>\" }\n    }\n  }\n}\n```\n\n### Example\n\n> \"The server is frozen again — power-cycle the socket it's plugged into.\"\n\nThe assistant finds the socket via `list_devices` and calls\n`power_cycle(device_id, off_seconds=10)`.\n\n### From source\n\n```bash\nuvx --from git+https://github.com/ssubbotin/yandex-iot-mcp yandex-iot-mcp\n```…","publisher":null,"homepage":"https://github.com/ssubbotin/yandex-iot-mcp","repository":"https://github.com/ssubbotin/yandex-iot-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["alice","iot","mcp","smart-home","yandex"],"pricing":null,"endpoints":[{"url":"pypi:yandex-iot-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.devices","name":"Devices & IoT","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yandex-iot-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:24.237Z","publishedAt":"2026-07-03T14:38:42.005191Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yandex-iot-mcp","url":"https://pypi.org/project/yandex-iot-mcp/","firstSeenAt":"2026-09-10T16:23:10.221Z","fetchedAt":"2026-09-10T16:23:10.221Z","normalizedAt":"2026-09-10T16:23:10.221Z"}]},"firstSeenAt":"2026-09-10T16:23:10.221Z","updatedAt":"2026-09-10T16:24:24.237Z"}