AI agents
Ask your AI about your connection.
HopSense on your computer answers your assistant from what it measured there: why the score moved, what happened last night, whether it was your Wi-Fi or your provider.
Claude Code · Claude Desktop · Codex · Gemini CLI · Cursor · VS Code · opencode · any MCP client
Connect yoursWhat's my connection score right now, and what's holding it back?
hopsense · status
Your connection score is 56 out of 100, which is "fair". Speed is the only thing holding it back.
- Responsiveness100
- Reliability100
- Speed52
The Speed figure is 47 Mbps down and 80 Mbps up. Your usual download on this network is about 232 Mbps, so you're at roughly 20% of normal. The figure comes from your two newest speed checks, and the index uses the lower of the two:
- 11:08 47 Mbps down. This is the one being counted.
- 12:18 110 Mbps down. This is better, but still under half of normal.
Latency and loss are clean everywhere, so the slowdown is probably in the available bandwidth, not in a fault on a leg.
Run a speed test now and tell me whether my internet is as fast as usual.
hopsense · run_speed_check
Yes, your internet is as fast as usual right now.
- Download 255.7 Mbps · Upload 188.8 Mbps
- Latency 4.1 ms idle and 8.8 ms under load
Your usual download on this network is about 242.8 Mbps, so today's figure is slightly above normal.
Connect it
One line, or one block in its settings. You need HopSense 0.1.54 or later on this computer; asking it for a speed check needs 0.1.55.
The program is /Applications/HopSense.app/Contents/MacOS/hopsense-agent
The program is "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" (PowerShell)
The program is ~/.local/bin/hopsense-agent
Claude Code
claude mcp add -s user hopsense -- /Applications/HopSense.app/Contents/MacOS/hopsense-agent mcpclaude mcp add -s user hopsense -- "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" mcpclaude mcp add -s user hopsense -- ~/.local/bin/hopsense-agent mcpCodex CLI
codex mcp add hopsense -- /Applications/HopSense.app/Contents/MacOS/hopsense-agent mcpcodex mcp add hopsense -- "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" mcpcodex mcp add hopsense -- ~/.local/bin/hopsense-agent mcpGemini CLI
gemini mcp add -s user hopsense /Applications/HopSense.app/Contents/MacOS/hopsense-agent mcpgemini mcp add -s user hopsense "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" mcpgemini mcp add -s user hopsense ~/.local/bin/hopsense-agent mcpopencode
opencode mcp add --global hopsense -- /Applications/HopSense.app/Contents/MacOS/hopsense-agent mcpopencode mcp add --global hopsense -- "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" mcpopencode mcp add --global hopsense -- ~/.local/bin/hopsense-agent mcpClaude Desktop
Add to Settings › Developer › Edit Config, then restart it:
{
"mcpServers": {
"hopsense": {
"command": "/Applications/HopSense.app/Contents/MacOS/hopsense-agent",
"args": [
"mcp"
]
}
}
}Add to Settings › Developer › Edit Config, then restart it:
{
"mcpServers": {
"hopsense": {
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\HopSense\\hopsense-agent.exe",
"args": [
"mcp"
]
}
}
}Cursor
Add to ~/.cursor/mcp.json, then restart it:
{
"mcpServers": {
"hopsense": {
"command": "/Applications/HopSense.app/Contents/MacOS/hopsense-agent",
"args": [
"mcp"
]
}
}
}Add to %USERPROFILE%\.cursor\mcp.json, then restart it:
{
"mcpServers": {
"hopsense": {
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\HopSense\\hopsense-agent.exe",
"args": [
"mcp"
]
}
}
}Add to ~/.cursor/mcp.json, then restart it:
{
"mcpServers": {
"hopsense": {
"command": "/home/<you>/.local/bin/hopsense-agent",
"args": [
"mcp"
]
}
}
}VS Code (Copilot, agent mode)
Add to MCP: Open User Configuration, then restart it:
{
"servers": {
"hopsense": {
"type": "stdio",
"command": "/Applications/HopSense.app/Contents/MacOS/hopsense-agent",
"args": [
"mcp"
]
}
}
}Add to MCP: Open User Configuration, then restart it:
{
"servers": {
"hopsense": {
"type": "stdio",
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\HopSense\\hopsense-agent.exe",
"args": [
"mcp"
]
}
}
}Add to MCP: Open User Configuration, then restart it:
{
"servers": {
"hopsense": {
"type": "stdio",
"command": "/home/<you>/.local/bin/hopsense-agent",
"args": [
"mcp"
]
}
}
}Any other assistant that speaks the Model Context Protocol: run the program with the one argument mcp, over standard input and output.
The skill
/Applications/HopSense.app/Contents/MacOS/hopsense-agent skill install& "$env:LOCALAPPDATA\Programs\HopSense\hopsense-agent.exe" skill install~/.local/bin/hopsense-agent skill installHow to read HopSense: one network at a time, whose fault each leg is, never a schedule of speed checks. For every assistant above but Claude Desktop, from HopSense 0.1.57.
What to ask
- Why is my connection score low?
- Did my internet drop last night? Was it my Wi-Fi or my provider?
- My video call froze around 11:30. What happened?
- Run a speed test and tell me whether my internet is as fast as usual.
- Write a short note for my provider’s support desk with the times and the evidence.
What it can see
Reads this computer
The history HopSense keeps on it, seven days, and its live reading. Nothing from our servers.
One action
A speed check when you ask for one, from HopSense 0.1.55. Your assistant asks you before it runs it.
Never given out
Your device’s ID, your dashboard link, your router’s address and your whole public address.
Where answers go
Nothing is sent to HopSense. What it answers goes to wherever your assistant’s model runs.
Tried with Claude Code, Codex and opencode on Linux, and the program itself on macOS. Tell us how it goes with yours: info@x3me.net.