Globalping MCP Server

Globalping MCP Server

What is it about?

Provides a Model Context Protocol (MCP) endpoint that lets AI assistants run network diagnostics—ping, traceroute, DNS, MTR, HTTP—and retrieve probe location data from the Globalping platform.

How to use it?

1. Choose a transport URL (streamable HTTP: https://mcp.globalping.dev/mcp or SSE: https://mcp.globalping.dev/sse).
2. Register the endpoint in an MCP‑compatible client (Claude Desktop, Anthropic Console, Cursor, etc.) using the npx mcp-remote <url> command.
3. Issue natural‑language requests such as “Ping google.com from 3 locations in Europe”.
4. The server translates the request into a Globalping API call, runs the measurement, and returns structured results for the LLM to consume.

Key Features

• Global network access – Measurements executed from thousands of probes worldwide.
• AI‑friendly interface – Results are formatted for easy parsing by any LLM.
• Comprehensive toolset – Supports ping, traceroute, dns, mtr, http, locations, limits, getMeasurement, compareLocations, and help.
• Smart context handling – Detailed parameter descriptions enable LLMs to choose appropriate measurement types and options.
• OAuth authentication – Use personal Globalping credentials for higher rate limits.
• Multiple transports – Streamable HTTP and Server‑Sent Events (SSE) are both available.

Use Cases

• Automated network troubleshooting – An LLM can diagnose connectivity issues across continents without manual CLI work.
• Performance benchmarking – Compare latency or HTTP response times of services from diverse regions.
• Educational assistants – Teach networking concepts by letting students ask natural‑language questions that trigger real measurements.
• DevOps monitoring – Integrate with AI‑driven incident response bots to automatically verify reachability of critical endpoints.
• Research data collection – Gather large‑scale latency datasets by commanding the LLM to run batch measurements.

FAQ

Q: Do I need a Globalping account? A: The server works with the public API, but providing OAuth credentials gives higher rate limits and access to private features.

Q: Which AI platforms are supported? A: Any MCP‑compatible tool, including Claude Desktop, Anthropic Assistants, Cursor, Windsurf, or custom implementations.

Q: How are locations specified? A: Use continent, country, city names, network tags, ASN numbers, or cloud‑region identifiers. Combine with a plus sign for finer targeting (e.g., London+UK).

Q: What transport should I choose? A: Both work; the streamable HTTP endpoint is generally simpler, while SSE provides real‑time event streaming.

Q: Can I retrieve past measurements? A: Yes, using the getMeasurement tool with the measurement ID returned by the original request.

Globalping MCP Server

What is Globalping?

Globalping is a free, public API that provides access to a globally distributed network of probes for monitoring, debugging, and benchmarking internet infrastructure. With Globalping, you can run network tests (ping, traceroute, DNS, MTR, HTTP) from thousands of locations worldwide.

What is the Globalping MCP Server?

The Globalping MCP Server implements the Model Context Protocol (MCP), allowing AI models like OpenAI's GPT and Anthropic's Claude to interact with Globalping's network measurement capabilities through natural language.

It also supports oAuth authentication, which offers a secure way to interact with our API and benefits from higher rate limits associated with your account.

Key Features

• 🌐 Global Network Access: Run measurements from thousands of probes worldwide
• 🤖 AI-Friendly Interface: Any LLM will easily parse the data and run new measurements as needed
• 📊 Comprehensive Measurements: Support for ping, traceroute, DNS, MTR, and HTTP tests
• 🔍 Smart Context Handling: Provides detailed parameter descriptions for AI clients to intelligently select measurement types and options
• 🔄 Comparative Analysis: Allows to compare network performance between different targets
• 🔑 oAuth Support: Use your own Globalping account for higher rate limits

Installation

The remote MCP server is available under these endpoints:

• Streamable HTTP transport: https://mcp.globalping.dev/mcp
• SSE transport: https://mcp.globalping.dev/sse

You can integrate our Globalping MCP server with various AI tools that support the Model Context Protocol.

Here are instructions for the top 3 most popular tools:

Claude Desktop App

Add to your Claude Desktop configuration file (located at %APPDATA%\Claude\config.json on Windows or ~/Library/Application Support/Claude/config.json on macOS):

Streamable HTTP transport:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/mcp"
            ]
        }
    }
}

Legacy SSE transport:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

Anthropic Claude API (via Console)

When creating a Claude Assistant in the Anthropic Console:

1. Go to console.anthropic.com
2. Navigate to the Assistants section
3. Create a new Assistant or edit an existing one
4. In the Tools section, select "Add custom tool"
5. Enter the following details:
   • Tool Name: Globalping
   • Description: Run network tests from locations worldwide
   • Tool URL: https://mcp.globalping.dev/mcp (Streamable HTTP transport) or https://mcp.globalping.dev/sse (SSE transport)

Cursor

To add the Globalping MCP server to Cursor:

1. Open Cursor settings
2. Navigate to the MCP tab
3. Click on "+ Add new global MCP server"
4. This opens the mcp.json config file, where you will need to add:

Streamable HTTP transport:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/mcp"
            ]
        }
    }
}

Legacy SSE transport:

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

5. Click "Save" and restart Cursor

Connecting AI Assistants

This MCP server can be used with any MCP-compatible AI assistant, including:

• Claude Desktop
• Anthropic Assistants
• Cursor
• Windsurf
• Any custom implementation of the MCP protocol

See the MCP documentation for details on connecting clients to this server.

Available Tools

• ping - Perform a ping test to a target
• traceroute - Perform a traceroute test to a target
• dns - Perform a DNS lookup for a domain
• mtr - Perform an MTR (My Traceroute) test to a target
• http - Perform an HTTP request to a URL
• locations - List all available Globalping probe locations
• limits - Show your current rate limits for the Globalping API
• getMeasurement - Retrieve a previously run measurement by ID
• compareLocations - Guide on how to run comparison measurements
• help - Show a help message with documentation on available tools

Usage Examples

Once connected to an AI model through a compatible MCP client, you can interact with Globalping using natural language:

Ping google.com from 3 locations in Europe

Run a traceroute to github.com from Japan and compare with traceroute from the US

Check the DNS resolution of example.com using Google DNS (8.8.8.8)

Is jsdelivr.com reachable from China? Test with both ping and HTTP

What's the average response time for cloudflare.com across different continents?

Location Specification

Locations can be specified using the "magic" field, which supports various formats:

• Continent codes: "EU", "NA", "AS", etc.
• Country codes: "US", "DE", "JP", etc.
• City names: "London", "Tokyo", "New York", etc.
• Network names: "Cloudflare", "Google", etc.
• ASN numbers: "AS13335", "AS15169", etc.
• Cloud provider regions: "aws-us-east-1", "gcp-us-central1", etc.

You can also combine these with a plus sign for more specific targeting: "London+UK", "Cloudflare+US", etc.

Development

The codebase is organized into modules:

• src/index.ts - Main entry point and MCP agent definition
• src/globalping/types.ts - TypeScript interfaces for the Globalping API
• src/globalping/api.ts - API wrapper functions for Globalping
• src/globalping/tools.ts - MCP tool implementations
• src/utils.ts - Helper utilities for rendering the web UI

Add Globalping credentials

Add Globalping OAuth credentials:

• npx wrangler secret put GLOBALPING_CLIENT_ID

KV storage

Used for OAuthProvider docs https://github.com/cloudflare/workers-oauth-provider

• create a KV namespace and copy ID
• binding for it must be OAUTH_KV
• configure kv_namespaces in the wrangler.jsonc file