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)

In ChatGPT, go to Settings → Security and login and enable Developer mode (or Settings → Features → MCP Servers in ChatGPT Desktop).
Add a new custom connector / MCP server with the endpoint:

https://mcp.globalping.dev/mcp

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:

In Claude, navigate to Settings → Connectors (or Organization settings → Connectors for Team/Enterprise accounts).
Click + Add custom connector.
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

Go to dash.globalping.io and generate an API token under Tokens.
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

Tool	Description
`ping`	Perform ICMP/packet ping tests to a destination
`traceroute`	Trace network routing hops to a target
`dns`	Resolve DNS queries using specific resolvers and record types
`mtr`	Run combined ping and traceroute tests (My Traceroute)
`http`	Execute HTTP/HTTPS requests from probes worldwide
`locations`	List available Globalping probe regions and filters
`limits`	Display the current free hourly test allowance and additional credits
`getMeasurement`	Retrieve results of a historical measurement by ID
`compareLocations`	Helper guide to compare multi-region performance metrics
`help`	Tool reference and syntax documentation
`authStatus`	Check the current MCP authentication status

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:

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

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
src		src
test		test
.gitignore		.gitignore
README.md		README.md
biome.json		biome.json
gemini-extension.json		gemini-extension.json
package-lock.json		package-lock.json
package.json		package.json
server.json		server.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts
vitest.workers.config.ts		vitest.workers.config.ts
worker-configuration.d.ts		worker-configuration.d.ts
wrangler.jsonc		wrangler.jsonc

Navigation Menu

Uh oh!

Repository files navigation

Globalping MCP Server

What is Globalping?

What is the Globalping MCP Server?

Key Features

Installation

ChatGPT & Codex

ChatGPT (Web & Desktop)

OpenAI Codex

Claude (Web, Desktop)

Claude Code

Cursor

Gemini CLI

VS Code & GitHub Copilot

Generic MCP Clients

Authentication

Using a Globalping API Token

Programmatic Integration (Anthropic Messages API)

Available Tools

Usage Examples

Location Specification

Troubleshooting and Support

The connector cannot reach the server

Authentication fails or expires

Get help or report a problem

Development

Credentials & Secrets

KV Storage Setup

About

Contributors

Languages

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Globalping MCP Server

What is Globalping?

What is the Globalping MCP Server?

Key Features

Installation

ChatGPT & Codex

ChatGPT (Web & Desktop)

OpenAI Codex

Claude (Web, Desktop)

Claude Code

Cursor

Gemini CLI

VS Code & GitHub Copilot

Generic MCP Clients

Authentication

Using a Globalping API Token

Programmatic Integration (Anthropic Messages API)

Available Tools

Usage Examples

Location Specification

Troubleshooting and Support

The connector cannot reach the server

Authentication fails or expires

Get help or report a problem

Development

Credentials & Secrets

KV Storage Setup

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages