ONT MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ONT MCP Why is my internet so slow tonight? Check the fibre box."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that lets Claude, Cursor, VS Code and other AI assistants read and safely configure fibre ONTs, or run 100% offline with a local model.
Tested on: Digisol DG-GR6011 (EPON) · see all tested hardware
Quick start · Tested hardware · What you can ask · Local models · Safety · Configuration · Troubleshooting
You: Why is my internet slow tonight? Check the fibre box.
Claude: ▸ ont_show status
▸ ont_show wan
Your ONT has been up for 18 hours and the WAN link is connected.
PPPoE session is up and the default gateway answers, so the fibre
line itself looks healthy. The slowdown is more likely on your Wi-Fi
or router. Want me to check the DHCP table for unknown devices?No web page with a captcha. No vendor app. No CLI manuals. You ask, your assistant reads the ONT, you get an answer.
✨ Why you'll like it
🧠 Learns your ONT by itself | Nothing is hardcoded. It asks your ONT's own CLI what it supports, so different models and firmware versions just work. |
🛡️ You approve every change | Reads are free. Every change pops up a dialog on your screen, and you have to type a word to allow it. The AI cannot click it for you. |
📦 Zero dependencies | One Python file, standard library only. No |
🔐 Your secrets stay yours | Your ONT's IP and password live in your config: Keychain, a password file or env vars. Never in this repo. |
🏡 Runs 100% offline | Pair it with a local model in LM Studio or Ollama, and nothing leaves your home network. |
🏠 Several ONTs | Home, office, parents' house: one server, one config, pick by name. |
🐢 Gentle on the hardware | ONTs have tiny memory. Sessions are paced and short, so the box stays healthy. |
Related MCP server: io.github.jeff-nasseri/mikrotik-mcp
📟 Tested hardware
Make | Model | Type | Firmware | Result |
Digisol | DG-GR6011 | EPON ONT (Realtek SDK) | V1.0.00-240813 | ✅ Tested on real hardware: SSH login, CLI discovery, |
Should also work: other ONTs whose SSH command line answers ? with a command list, which is common on Realtek-based GPON/EPON ONTs. The server learns each box's commands itself, so nothing is model-specific.
Got another make or model working? Open an issue with the make, model, firmware and the output of ont-mcp --check. It takes 2 minutes and gets your box into this table. ❤️
🚀 Quick start (3 minutes)
1 · Turn on SSH on your ONT
Open your ONT's web page (the address is on the sticker under the box, often 192.168.1.1), find Remote Access (sometimes Service Control) and allow SSH on the LAN side. Then check it works from a terminal:
ssh admin@192.168.1.1If you get a > prompt, you're good. Type exit.
Got
no matching host key type? Your ONT uses older SSH algorithms. Use the command in Troubleshooting.
2 · Store the ONT password safely
Pick one:
security add-generic-password -s ont-mcp -a admin -wIt asks for the password and stores it encrypted. Then use "ONT_KEYCHAIN": "ont-mcp" below.
secret-tool store --label="ONT MCP" service ont-mcp user adminThen use "ONT_KEYCHAIN": "ont-mcp" below.
mkdir -p ~/.config/ont-mcp
printf '%s' 'YOUR-ONT-PASSWORD' > ~/.config/ont-mcp/ont.password
chmod 600 ~/.config/ont-mcp/ont.passwordThen use "ONT_PASSWORD_FILE": "~/.config/ont-mcp/ont.password" below.
3 · Add it to your AI app
You need Python 3.9+ (already on macOS and Linux). uv is the easiest way to run it, with no clone and no install:
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"ont": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Santhosh17/ont-mcp", "ont-mcp"],
"env": {
"ONT_HOST": "192.168.1.1",
"ONT_KEYCHAIN": "ont-mcp"
}
}
}
}Restart Claude Desktop.
claude mcp add ont --scope user \
-e ONT_HOST=192.168.1.1 -e ONT_KEYCHAIN=ont-mcp \
-- uvx --from git+https://github.com/Santhosh17/ont-mcp ont-mcpSame JSON as Claude Desktop, under "mcpServers".
{
"servers": {
"ont": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Santhosh17/ont-mcp", "ont-mcp"],
"env": { "ONT_HOST": "192.168.1.1", "ONT_KEYCHAIN": "ont-mcp" }
}
}
}Program → Install → Edit mcp.json:
{
"mcpServers": {
"ont": {
"command": "python3",
"args": ["/full/path/to/ont-mcp/ont_mcp.py"],
"env": { "ONT_HOST": "192.168.1.1", "ONT_KEYCHAIN": "ont-mcp" }
}
}
}Desktop apps often don't see uvx on their PATH, so this uses a clone and python3. See Run it 100% locally.
git clone https://github.com/Santhosh17/ont-mcpThen use "command": "python3" and "args": ["/full/path/to/ont-mcp/ont_mcp.py"].
(On Windows: "command": "python".)
✅ Check it
ONT_HOST=192.168.1.1 ONT_KEYCHAIN=ont-mcp uvx --from git+https://github.com/Santhosh17/ont-mcp ont-mcp --check• ont admin@192.168.1.1:22
✓ logged in. CLI commands: backup, config, debug, exit, help, reboot, restore, showThat's it. Ask your assistant "What's the status of my ONT?" 🎉
💬 What you can ask
Ask | What happens |
"Is my fibre connection up? What's the WAN IP?" | reads |
"Which devices are on my network right now?" | reads |
"Is Telnet open on my ONT? It shouldn't be." | reads |
"Forward port 8080 to my home server at 192.168.1.50" | explores |
"What firmware am I running?" | reads |
"Explain my ONT's routing table like I'm five" | reads |
"Reboot the ONT" | dialog: you must type REBOOT |
🏡 Run it 100% locally
Prefer your ONT's data never leaves the house? MCP works with any model, so pair this server with a local one and no question, answer or ONT output goes to the cloud.
Apps: LM Studio (config in Quick start), or any MCP app that runs local models: Jan, Goose, Cline, Continue. Open WebUI needs an HTTP bridge such as
mcpo.Models: pick one that's good at tool calling, ideally 14B or larger (Qwen 3, Mistral Small, gpt-oss-20b). Tested with Qwen3.8 27B in LM Studio: it found the right tools by itself and checked settings before proposing changes. Models under ~7B often call the wrong tool.
Safety doesn't depend on the model. Command checks and the approval dialog run in the server, so even a confused model can't change anything without you. Trying a small model? Add
"ONT_READ_ONLY": "1"for extra peace of mind.
🛡️ Safety: built in, not bolted on
Your ONT is the only thing between your home and the internet. This server treats it that way.
flowchart LR
A[AI asks to run a command] --> B{What kind?}
B -->|show … / help ?| C[✅ Runs right away]
B -->|not a real command<br/>on this ONT| D[⛔ Refused, with the list<br/>of real commands]
B -->|a change| E[🪟 Dialog on YOUR screen]
E -->|you type YES / the keyword| F[✅ Runs]
E -->|cancel, wrong word,<br/>timeout or no screen| G[⛔ Not run]Human approval for every change. The dialog shows the ONT, the exact command, the risk and the AI's reason. The AI cannot see or answer it.
Stronger lock on dangerous commands. For
reboot,reset,restore, firmware, WAN/LAN/PPP/VLAN, accounts and remote access, you must type the word itself (REBOOT,WAN, …), not justYES.Read-only mode. Set
"read_only": true(orONT_READ_ONLY=1) and changes are off completely. Great for a parent's ONT.Only real commands. Anything your ONT's CLI doesn't list is refused before it reaches the box.
One command per call. Line breaks and control characters are rejected, so nothing can sneak in a second command.
No dialog, no change. On a headless server, changes are simply refused.
Approval dialogs use AppleScript on macOS, PowerShell on Windows, and zenity or kdialog on Linux.
⚙️ Configuration
Your ONT details are never in this repo. Give them to the server in one of two ways.
One ONT: environment variables
Put these in the env block of your AI app's config:
Variable | Default | What it is |
| required | ONT IP address, e.g. |
|
| SSH username |
|
| SSH port |
| Keychain (macOS) / Secret Service (Linux) entry name | |
| Path to a file holding only the password | |
| The password itself (easiest, least safe) | |
|
| Friendly name shown in approval dialogs |
| off |
|
|
| Regex for the CLI prompt, only if yours is unusual |
Several ONTs: a JSON file
Copy ont.example.json to ~/.config/ont-mcp/ont.json (found automatically) or anywhere you like and point ONT_CONFIG at it:
{
"default": "home",
"devices": {
"home": { "host": "192.168.1.1", "keychain": "ont-home", "label": "Home ONT" },
"office": { "host": "192.168.10.1", "password_file": "~/.config/ont-mcp/office.password",
"read_only": true }
}
}Device fields: host, user, port, label, keychain, password_file, password, read_only, prompt. A typo such as pasword is reported clearly instead of failing silently.
The tools then take a device argument: "check the office ONT".
🧰 Tools
Tool | Does | Approval |
|
| never |
| asks the CLI what exists under a path ( | never |
| any change: | always |
🩺 Troubleshooting
You see | Fix |
| Check the password in your keychain/file. The SSH login is usually the same as the web login. |
| Enable SSH under Remote Access in the ONT web page. |
| Wrong IP, or this computer isn't on the ONT's network (for example, it's behind another router). |
|
|
| Expected after a factory reset or firmware update: |
| Linux: install |
| Set |
The first answer takes ~10 s | Normal: on first use it learns your ONT's commands, and sessions are paced to protect the box. |
Still stuck? Run ont-mcp --check and paste the output into an issue.
❓ FAQ
The web login has a captcha, and the pages load the ONT's small memory heavily. The SSH CLI is fast, scriptable and gentle.
No. Every change waits for a dialog on your screen that only a person can answer. With read_only, changes are off completely.
Only to your ONT, over SSH, on your local network. The server hands it to ssh through a private, one-shot helper. It's never logged, never in tool output, never sent to the AI.
Only if your ONT's CLI exposes them. Many firmwares show them only in the web page. Ask your assistant to run ont_help and see what your box offers.
No. It's an independent open-source project, not affiliated with or endorsed by any ONT manufacturer. Digisol and other product names are trademarks of their owners, used here only to say which hardware has been tested.
🤝 Contributing
Device reports, bug fixes and docs are all welcome: see CONTRIBUTING.md.
python3 -m unittest -v # offline tests, no ONT needed (includes a fake ONT over a real SSH flow)⚠️ Disclaimer
Changing ONT settings can cut your internet, voice or IPTV, and may break your provider's terms. You approve every change; you own the result. Provided under the MIT License, with no warranty.
If this saved you a trip to a captcha-protected web page, a ⭐ helps others find it.
Available Tools
3 toolsont_helpA
Ask the ONT's own CLI what commands exist under a path: '' for the top level, 'show', 'config', 'config wan' and so on. Read-only: it only appends '?'. Use it to explore before running a change.
Inputs: path.
ont_runA
Run a command that changes the ONT (config ..., save, reboot, ...). Before it runs, the person at the computer sees a dialog naming the ONT, the command and its risk, and must type a confirmation word; you cannot answer it. High-impact commands (reboot, reset, restore, firmware, WAN/LAN/PPP/VLAN, accounts, remote access) need that word typed. Explain in 'reason' why the change is needed. Many ONTs need a save command (for example 'config save') before a change survives a reboot.
Inputs: command (required), reason.
ont_showA
Read status or settings from the fibre ONT with 'show '. Read-only, safe. Common items: status (uptime, firmware, WAN), wan, interface, lan, dhcp, arp, route, remoteaccess, portforward, tr069. Call ont_help with path 'show' to list every item this ONT offers.
Inputs: item (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools split cleanly along read / discover / write lines: ont_show reads values, ont_help enumerates the CLI tree read-only, and ont_run executes changes behind a confirmation dialog. An agent can pick correctly from the verb alone, and the descriptions reinforce the boundary by naming the safety semantics of each.
All three follow the same ont_<verb> pattern (ont_show, ont_help, ont_run) with lowercase snake-style and a single shared namespace prefix. No mixed conventions or stray casing.
Three tools is on the lean side, but for a generic CLI passthrough this is the right shape: one read path, one discovery path, one mutation path, with domain breadth handled by arguments rather than tool proliferation. Slightly under-scoped only if one expected dedicated helpers for common tasks like save or status.
Read, explore, and mutate are all covered, including a confirmation flow and guidance about needing 'config save' after changes. Minor gaps: no structured/parsed output contract, no dedicated save or reboot convenience tool, and no session/logout or firmware-upload handling, though all are reachable via ont_run.
Maintenance
Related MCP Connectors
Give your AI hands on every computer you own. Remote control of your Windows, Mac and Linux machines from one ChatGPT, Claude or Cursor chat — even from your phone. Ask it to find out why the office server is crawling, update every PC in the house, sort out your mom's laptop from another city, or ship the site from your work machine while you're on a train. It runs commands, reads files and takes a screenshot when it needs to see the screen. You decide what each computer allows, and you can cut any of them off in a second.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Reach your own computers from any AI app: files, search, commands, approvals and outage alerts.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- AlicenseCqualityAmaintenanceProvides a bridge between AI assistants and MikroTik RouterOS devices, enabling natural language management of VLANs, firewall rules, DNS settings, and more.2391,052 PyPI337MIT
- AlicenseNot gradedqualityCmaintenanceBridges AI assistants with MikroTik RouterOS devices, enabling natural language management of network configurations, firewall, VLANs, VPNs, and diagnostics via ~300 tools.1MIT
- AlicenseAqualityBmaintenanceEnables AI apps to inspect and manage a NextDNS account in plain language — profiles, analytics, query logs, blocklists, security and parental control settings — with every change saved and reversible via undo. It runs self-hosted on your own computer or server, keeps per-profile read/write/hidden permissions, and requires double confirmation for deletions or overwrites.23Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Cisco, Huawei, and H3C network switches over Telnet, SSH, or Console serial connections, with automatic vendor detection, paging and prompt handling, and cleaned command output. A local SSE web console streams every command and device response in real time so operators can watch what the AI is doing.1MIT