CommunityWriting & Editinggithub.com

Deco BE85 Agent Skill

A collection of agent skills for managing TP-Link Deco BE85 mesh Wi-Fi systems via a FastAPI wrapper API, designed for use with Claude Code, Codex, and Antigravity.

What is Deco BE85 Agent Skill?

This skill provides a comprehensive set of tools for AI agents to interact with and control a TP-Link Deco BE85 mesh router system through a FastAPI middleware API. It enables agents to read dashboard statistics, list connected and blocked clients, manage Wi-Fi settings (SSID, password, channel, on/off per band), check WAN/LAN/IPv6 status, monitor CPU and memory usage, and even reboot the entire network. The API handles authentication automatically, so no credentials are needed in requests. The skill also includes safe usage guards: write operations (Wi-Fi toggles, config changes, reboot) require explicit user confirmation before proceeding, and all requests should be made sequentially due to a server-side lock. The skill is designed for AI agents like Claude Code, Codex, and Antigravity, with clear documentation of error codes and endpoint schemas.

Works with✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Deco BE85

Base URL: https://deco.msageha.net/api (FastAPI wrapper around the TP-Link Dec BE85 local API). Requests to this instance don't need any authentication header/cookie — the server logs into the router itself with stored credentials.

Key facts

  • Login to the router is lazy: the first call after startup/idle triggers it and is slower. Expired sessions are re-logged-in and retried automatically.
  • Requests are serialized behind a server-side lock (single router session). Call endpoints sequentially; don't fan out parallel requests.
  • band is band2_4 / band5_1 / band6; network is host / guest.
  • GET /wireless returns ssid/password base64-encoded; write endpoints accept them in plain text (the server encodes them).
  • Confirm with the user before any write: Wi-Fi toggles/config changes briefly disconnect clients on that band, POST /reboot (requires confirm: true) takes the whole network down for minutes, and POST /raw with a non-read operation can change arbitrary router settings.
  • Errors: 401 router auth failure, 502 router-side error (detail + error_code), 504 router unreachable, 400/422 request validation.

Core operations

TaskEndpoint
Overview (WAN/CPU/mem/node & client counts)GET /dashboard
Deco units (mesh nodes)GET /devices
Connected clientsGET /clients?online_only=true
Blocked clientsGET /clients/blocked
Wi-Fi settings (all bands, host/guest)GET /wireless
Wi-Fi ON/OFF per bandPOST /wireless
Change SSID/password/channel etc.POST /wireless/config
WAN / internet / LAN / IPv6 statusGET /network/wan, /network/internet, /network/lan, /network/ipv6
CPU / memory usageGET /network/performance
Reboot Deco units (destructive)POST /reboot
Any other Deco endpoint (escape hatch)POST /raw
Server health / explicit loginGET /health, POST /login, POST /logout

Full request/response schemas and ready-to-run curl examples: see references/api-reference.md and references/commands.md.

Related Skills