io.globalping/mcp

Globalping MCP Server

Enable AI models to interact with a global network measurement platform through natural language. Give network access to any LLM.

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 and IDE assistants to interact with Globalping's network measurement capabilities through natural language.

The server supports standard OAuth 2.0 authentication as well as API token authentication for automated workflows.

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: Detailed parameter descriptions and semantic tool annotations for intelligent agent routing
• 🔄 Comparative Analysis: Compare network latency and routing between different targets and geographic locations
• 🔑 Authentication Support: Use OAuth or an API token with your Globalping account for higher rate limits

---

Installation

The primary endpoint for all modern MCP integrations is:

https://mcp.globalping.dev/mcp Streamable HTTP

ChatGPT & Codex

Connect Globalping as a remote MCP server in ChatGPT and Codex:

ChatGPT (Web & Desktop)

1. In ChatGPT, go to Settings → Security and login and enable Developer mode (or Settings → Features → MCP Servers in ChatGPT Desktop).
2. Add a new custom connector / MCP server with the endpoint: text https://mcp.globalping.dev/mcp
3. Authenticate via OAuth when prompted.

OpenAI Codex

Add the remote server using the Codex CLI:

codex mcp add globalping --url https://mcp.globalping.dev/mcp

Or add to ~/.codex/config.toml directly:

[mcp_servers.globalping]
url = "https://mcp.globalping.dev/mcp"

Claude (Web, Desktop)

Claude supports remote Streamable HTTP MCP connectors natively without requiring local mcp-remote bridges:

1. In Claude, navigate to Settings → Connectors (or Organization settings → Connectors for Team/Enterprise accounts).
2. Click + Add custom connector.
3. Fill in the connector details:

• Name: Globalping
• URL: https://mcp.globalping.dev/mcp

Claude Code

Run the following command in your terminal:

claude mcp add --transport http globalping https://mcp.globalping.dev/mcp

To make Globalping available across all projects on your machine (global user scope) instead of just the current project directory:

claude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp

Run claude mcp login globalping --no-browser if working over SSH or in a headless terminal to complete the authorization URL exchange manually.

Cursor

Add Globalping to Cursor in one click:

Or configure manually in Settings → Features → MCP Servers → Add New MCP Server:

• Type: SSE / HTTP
• Name: globalping
• URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping is indexed in the official Gemini CLI Extensions Gallery.

Install via the Gemini extension manager:

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

(Add --auto-update to keep the extension automatically updated).

VS Code & GitHub Copilot

• Command Palette: Run MCP: Add Server and enter https://mcp.globalping.dev/mcp.

Generic MCP Clients

For any client supporting the standard Streamable HTTP MCP transport, add:

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp"
    }
  }
}

Legacy Clients (SSE / stdio fallback): If your client strictly requires SSE over a local process bridge, configure npx mcp-remote https://mcp.globalping.dev/sse.

---

Authentication

Globalping MCP supports two authentication modes:

• OAuth 2.0: Handled automatically in interactive clients during connection.
• API Token: Useful for headless scripts, CI/CD pipelines, or programmatic API clients.

Using a Globalping API Token

1. Go to dash.globalping.io and generate an API token under Tokens.
2. Pass the token via standard HTTP headers:

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GLOBALPING_API_TOKEN"
      }
    }
  }
}

---

Programmatic Integration (Anthropic Messages API)

To use Globalping directly with Anthropic's Messages API (MCP Connector), pass the remote server definition in your request payload:

{
  "model": "claude-3-7-sonnet-latest",
  "max_tokens": 1024,
  "mcp_servers": [
    {
      "type": "url",
      "name": "globalping",
      "url": "https://mcp.globalping.dev/mcp"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "globalping"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "Run a traceroute to 1.1.1.1 from Frankfurt and Tokyo."
    }
  ]
}

---

Available Tools

---

Usage Examples

Once connected, run network diagnostics 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 location's magic parameter:

• Continents: EU, NA, AS, AF, OC, SA
• Country codes: US, DE, JP, PL, BR
• Cities: London, Tokyo, New York, Warsaw
• Networks & ASNs: Cloudflare, Google, AS13335, AS15169
• Cloud regions: aws-us-east-1, gcp-us-central1
• Combinations: London+UK, Cloudflare+US, AWS+Frankfurt

---

Troubleshooting and Support

The connector cannot reach the server

• Use the Streamable HTTP endpoint exactly as shown: https://mcp.globalping.dev/mcp.
• A 401 Unauthorized response before completing OAuth is expected. Reconnect the integration and finish the browser authorization flow.
• Use the legacy /sse endpoint only for clients that do not support Streamable HTTP.

Authentication fails or expires

• Remove and reconnect the integration to start a fresh OAuth flow.
• For API-token authentication, generate a current token in the Globalping dashboard and send it as Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Once connected, use the authStatus tool to verify that authentication is active and the limits tool to check the free hourly test allowance and available credits. The displayed rate limit covers free tests only; authenticated users with credits can continue above it by spending one credit per additional test.

Get help or report a problem

• For usage questions and reproducible bugs, open a GitHub issue.
• For security-sensitive reports, use GitHub's private Report a vulnerability form. Do not include credentials or sensitive data in a public issue.
• Globalping's Privacy Policy and Terms of Use apply to this service.

---

Development

src/
├── index.ts        # Main entry point & MCP agent definition
├── app.ts          # OAuth web routes
├── api/            # Globalping API client
├── auth/           # Authentication helpers
├── config/         # Configuration & constants
├── lib/            # Utilities
├── mcp/            # MCP tool definitions & handlers
├── types/          # TypeScript interfaces
└── ui/             # OAuth HTML templates

Credentials & Secrets

Store OAuth credentials:

npx wrangler secret put GLOBALPING_CLIENT_ID

For OpenAI plugin-directory domain verification, store the token generated by the submission portal:

npx wrangler secret put OPENAI_APPS_CHALLENGE

The Worker serves this value as plain text from /.well-known/openai-apps-challenge. The route returns 404 until the secret is configured.

KV Storage Setup

For Cloudflare Workers OAuth state management:

1. Create a KV namespace: npx wrangler kv:namespace create OAUTH_KV
2. Configure OAUTH_KV inside wrangler.jsonc.