# SpeedOf.Me

Run a live connection check from an AI agent and get download, upload, latency, and jitter results. The server can also retrieve earlier tests.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: SpeedOfMe
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SpeedOfMe/speedofme-mcp
- Updated: 2026-09-19
- HTML: https://affpapa.org/en/nevibecode/mcp/speedofme

## What it does

The `run_speed_test` tool checks the connection and returns download and upload speeds, latency, and jitter. Use `get_test_history` to retrieve saved results; the server also exposes resources for recent history and its current configuration. Measurements use the nearest SpeedOf.Me edge location, and test records are kept in `~/.speedofme/history.json`.

You need Node.js 18 or later and a SpeedOf.Me API secret. Set it as `SOM_API_SECRET`; the test cannot run without that credential. To add the server to Claude Code, run `claude mcp add speed-test -e SOM_API_SECRET=<SOM_API_SECRET> -- npx -y @speedofme/mcp`, then restart the client.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SOM_API_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add speed-test -e SOM_API_SECRET=<SOM_API_SECRET> -- npx -y @speedofme/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add speedofme --env SOM_API_SECRET=<SOM_API_SECRET> -- npx -y @speedofme/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "speedofme": {
            "command": "npx",
            "args": [
                "-y",
                "@speedofme/mcp"
            ],
            "env": {
                "SOM_API_SECRET": "<SOM_API_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "speedofme": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@speedofme/mcp"
            ],
            "env": {
                "SOM_API_SECRET": "<SOM_API_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SOM_API_SECRET=<SOM_API_SECRET> speedofme npx -y @speedofme/mcp
```
Replace <…> with your own values

## When to use it
- check current download and upload speeds
- measure connection latency and jitter
- retrieve previous test results
- filter saved results by date with `since`

## Example prompts
- Run a SpeedOf.Me check and report my download, upload, and latency.
- Show me my previous SpeedOf.Me tests.
- Find SpeedOf.Me results after this date and compare them.

## Similar
- [mcp](https://affpapa.org/en/nevibecode/mcp/jsdelivr-mcp.md) — MCP server · ★ 65
- [traffic-analysis-pcap](https://affpapa.org/en/nevibecode/skills/traffic-analysis-pcap.md) — skill · 3700 installs
- [network-request-auditing](https://affpapa.org/en/nevibecode/skills/network-request-auditing.md) — skill · 435 installs
- [dt-obs-network-flows](https://affpapa.org/en/nevibecode/skills/dt-obs-network-flows.md) — skill · 920 installs
- [dt-obs-network-devices](https://affpapa.org/en/nevibecode/skills/dt-obs-network-devices.md) — skill · 915 installs
- [connectivity-triage](https://affpapa.org/en/nevibecode/skills/connectivity-triage.md) — skill · 743 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md