{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8z3mchqys9fe","handle":"openwrt-mcp","url":"https://wellknown.network/agents/openwrt-mcp","links":{"self":"https://wellknown.network/agents/openwrt-mcp/record.json","html":"https://wellknown.network/agents/openwrt-mcp","markdown":"https://wellknown.network/agents/openwrt-mcp/record.md","api":"https://wellknown.network/api/v1/agents/openwrt-mcp","status":"https://wellknown.network/api/v1/agents/openwrt-mcp/status","claim":"https://wellknown.network/agents/openwrt-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/openwrt-mcp/claim.json","badge":"https://wellknown.network/agents/openwrt-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/openwrt-mcp/history","tools":"https://wellknown.network/api/v1/agents/openwrt-mcp/tools"},"ard":{"identifier":"urn:air::server:openwrt-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"openwrt-mcp","summary":"A MCP server for OpenWrt devices. This is a very early version and may contain unexpected errors.","description":"# OpenWrt MCP Controller\n\nThis project provides a Model Context Protocol (MCP) server for managing OpenWrt devices. It allows you to interact with and control an OpenWrt router through a simple API.\n\nThe server utilizes `fastmcp` to expose OpenWrt functionalities as tools that can be called remotely.\n\n## 1. Prerequisites\n\nFor the server to have full functionality, a custom LuCI RPC script must be placed on the target OpenWrt device.\n\n### Install `sys.lua` on OpenWrt\n\nThe `sys.lua` file in this repository extends the capabilities of the LuCI JSON-RPC interface. You must copy this file to your OpenWrt router for tools like `system_status`, `network_status`, and `set_led_state` to work.\n\n1.  **Copy the file to your OpenWrt device:**\n    Use `scp` or any other file transfer method to copy `sys.lua` to your router.\n\n    ```sh\n    scp sys.lua root@<your_openwrt_ip>:/usr/lib/lua/luci/sys.lua\n    ```\n\n2.  **Verify Permissions:**\n    Ensure the file has the correct permissions.\n\n    ```sh\n    ssh root@<your_openwrt_ip> \"chmod 644 /usr/lib/lua/luci/sys.lua\"\n    ```\n\n## 2. Installation\n\nYou can install this package directly from PyPI.\n\n```sh\npip install openwrt-mcp\n```\n\n## 3. Configuration\n\nThe server is configured through environment variables. You must set the following before running the server:\n\n-   `OPENWRT_HOST`: The full URL of your OpenWrt device (e.g., `http://192.168.1.1`).\n-   `OPENWRT_PASSWORD`: The login password for your OpenWrt device.\n-   `OPENWRT_USERNAME`: (Optional) The login username. Defaults to `root`.\n\nExample:\n```sh\nexport OPENWRT_HOST=\"http://192.168.1.1\"\nexport OPENWRT_PASSWORD=\"your_secret_password\"\n```\n\n## 4. Usage\n\nOnce installed and configured, you can start the MCP server with the following configuration:\n\n```sh\n{\n    \"mcpServers\":{\n        \"openwrt-mcp\":{\n            \"command\":\"uvx\",\n            \"args\": [\n                \"openwrt-mcp\"\n            ],\n            \"env\":{\n                \"OPENWRT_HOST\":\"192.168.0.1\",\n                \"OPENWRT_PASSW…","publisher":null,"homepage":null,"repository":null,"version":"0.1.7","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:openwrt-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"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":"openwrt-mcp","registry":"pypi","observedAt":"2026-11-09T23:24:56.815Z","publishedAt":"2025-11-10T01:31:41.105019Z","latestVersion":"0.1.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"openwrt-mcp","url":"https://pypi.org/project/openwrt-mcp/","firstSeenAt":"2026-09-10T08:27:02.112Z","fetchedAt":"2026-11-09T23:22:50.801Z","normalizedAt":"2026-11-09T23:22:50.801Z"}]},"firstSeenAt":"2026-09-10T08:27:02.112Z","updatedAt":"2026-11-09T23:24:56.815Z"}