SpeedOf.Me MCP server

SpeedOf.Me MCP Server

Official MCP server for SpeedOf.Me. Lets an AI agent run a real internet speed test and read the result: download, upload, latency and jitter, measured against 130+ global edge servers.

"How fast is my connection right now?"
→ 187.4 Mbps down / 41.2 Mbps up / 11 ms latency / 1.8 ms jitter (San Jose)

Tools

Quick start

1. Get a free API secret

Register, then open Integrations and generate a secret.

2. Add the server to your MCP client

{
  "mcpServers": {
    "speedofme": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@speedofme/mcp"],
      "env": {
        "SOM_API_SECRET": "SOM_SECRET_xxx"
      }
    }
  }
}

Claude Code, one command:

claude mcp add speedofme --env SOM_API_SECRET=SOM_SECRET_xxx -- npx -y @speedofme/mcp

VS Code (Copilot) uses servers instead of mcpServers in .vscode/mcp.json; the rest of the block is identical. Cursor, Windsurf, Zed, Cline, Continue, JetBrains and Goose all take the JSON above. Client-specific configs and agent-framework examples (LangChain, LlamaIndex, AutoGen, CrewAI, Semantic Kernel) are in the integration docs.

3. Restart the client and ask for a speed test.

Tool reference

runspeedtest

The tool replies with formatted text. The underlying result looks like this:

{
  "testId": "abc123",
  "download": 150.5,
  "upload": 45.2,
  "latency": 12,
  "jitter": 2.3,
  "testServer": "San Jose",
  "timestamp": "2026-08-18T10:30:00Z"
}

Speeds are Mbps, latency and jitter are milliseconds.

gettesthistory

History is stored locally in ~/.speedofme/history.json, capped at 1 MB (roughly 2,600 results).

Also a CLI

The same package runs standalone, no MCP client required:

SOM_API_SECRET=SOM_SECRET_xxx npx -y @speedofme/mcp --progress   # human readable
SOM_API_SECRET=SOM_SECRET_xxx npx -y @speedofme/mcp --json       # for scripts
npx -y @speedofme/mcp history --limit 5                          # past results
npx -y @speedofme/mcp --help

And as a Node SDK:

const { SpeedTest } = require('@speedofme/mcp');

const test = new SpeedTest({ apiSecret: process.env.SOM_API_SECRET });
const result = await test.run();          // { download, upload, latency, jitter, ... }

Shortened. The full README is on GitHub.