[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_111":112},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":11,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":-5,"_79":-5,"_80":49,"_81":-5,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","jsdelivr","moduleId","globalping-mcp-server","@jsdelivr/globalping-mcp-server","displayName","globalping mcp server","tagline","Interact with a global network measurement platform.Run network commands from any point in the world","iconKey","https://avatars.githubusercontent.com/u/6191378?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.globalping.io/sse\",\"transport\":\"sse\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783399396000,"updatedAt",1788333307000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.globalping%2Fmcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",63,"upstreamUpdatedAt",1788210765000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt",1787636420000,"githubRepoUrl","https://github.com/jsdelivr/globalping-mcp-server","githubRepoFullName","jsdelivr/globalping-mcp-server","releaseId","ext-jsdelivr-globalping-mcp-server","version","1.0.0","descriptionMarkdown","# Globalping MCP Server\n\n

\n $\"Globalping$ \n

\n\n

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

\n\n

\n \n $\"MCP$ \n \n

\n\n## What is Globalping?\n\n[Globalping](https://globalping.io) 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.\n\n## What is the Globalping MCP Server?\n\nThe Globalping MCP Server implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io), allowing AI models and IDE assistants to interact with Globalping's network measurement capabilities through natural language.\n\nThe server supports standard **OAuth 2.0 authentication** as well as **API token authentication** for automated workflows.\n### Key Features\n\n* 🌐 **Global Network Access**: Run measurements from thousands of probes worldwide\n* 🤖 **AI-Friendly Interface**: Any LLM will easily parse the data and run new measurements as needed\n* 📊 **Comprehensive Measurements**: Support for ping, traceroute, DNS, MTR, and HTTP tests\n* 🔍 **Smart Context Handling**: Detailed parameter descriptions and semantic tool annotations for intelligent agent routing\n* 🔄 **Comparative Analysis**: Compare network latency and routing between different targets and geographic locations\n* 🔑 **Authentication Support**: Use OAuth or an API token with your Globalping account for higher rate limits\n\n---\n\n## Installation\n\nThe primary endpoint for all modern MCP integrations is:\n\n`https://mcp.globalping.dev/mcp` Streamable HTTP\n\n### ChatGPT & Codex\n\nConnect Globalping as a remote MCP server in ChatGPT and Codex:\n\n#### ChatGPT (Web & Desktop)\n\n1. In ChatGPT, go to **Settings** → **Security and login** and enable **Developer mode** (or **Settings** → **Features** → **MCP Servers** in ChatGPT Desktop).\n2. Add a new custom connector / MCP server with the endpoint:\n```text\nhttps://mcp.globalping.dev/mcp\n```\n\n\n3. Authenticate via OAuth when prompted.\n\n#### OpenAI Codex\n\nAdd the remote server using the Codex CLI:\n\n```bash\ncodex mcp add globalping --url https://mcp.globalping.dev/mcp\n```\n\n*Or add to `~/.codex/config.toml` directly:*\n\n```toml\n[mcp_servers.globalping]\nurl = \"https://mcp.globalping.dev/mcp\"\n```\n\n### Claude (Web, Desktop)\n\nClaude supports remote Streamable HTTP MCP connectors natively without requiring local `mcp-remote` bridges:\n\n1. In Claude, navigate to **Settings** → **Connectors** (or **Organization settings** → **Connectors** for Team/Enterprise accounts).\n2. Click **+ Add custom connector**.\n3. Fill in the connector details:\n* **Name**: `Globalping`\n* **URL**: `https://mcp.globalping.dev/mcp`\n\n#### Claude Code\n\nRun the following command in your terminal:\n\n```bash\nclaude mcp add --transport http globalping https://mcp.globalping.dev/mcp\n```\n\nTo make Globalping available across all projects on your machine (global user scope) instead of just the current project directory:\n\n```bash\nclaude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp\n```\n\n*Run `claude mcp login globalping --no-browser` if working over SSH or in a headless terminal to complete the authorization URL exchange manually.*\n\n\n### Cursor\n\nAdd Globalping to Cursor in one click:\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=Globalping&config=eyJ1cmwiOiJodHRwczovL21jcC5nbG9iYWxwaW5nLmRldi9tY3AifQ%3D%3D)\n\n*Or configure manually in **Settings** → **Features** → **MCP Servers** → **Add New MCP Server**:*\n\n* **Type**: `SSE / HTTP`\n* **Name**: `globalping`\n* **URL**: `https://mcp.globalping.dev/mcp`\n\n### Gemini CLI\n\nGlobalping is indexed in the official **[Gemini CLI Extensions Gallery](https://geminicli.com/extensions/?name=jsdelivrglobalping-mcp-server)**.\n\nInstall via the Gemini extension manager:\n\n```bash\ngemini extensions install https://github.com/jsdelivr/globalping-mcp-server\n```\n\n*(Add `--auto-update` to keep the extension automatically updated).*\n\n### VS Code & GitHub Copilot\n\n* **Command Palette**: Run `MCP: Add Server` and enter `https://mcp.globalping.dev/mcp`.\n\n### Generic MCP Clients\n\nFor any client supporting the standard Streamable HTTP MCP transport, add:\n\n```json\n{\n \"mcpServers\": {\n \"globalping\": {\n \"url\": \"https://mcp.globalping.dev/mcp\"\n }\n }\n}\n```\n\n> **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`.\n\n---\n\n## Authentication\n\nGlobalping MCP supports two authentication modes:\n\n* **OAuth 2.0**: Handled automatically in interactive clients during connection.\n* **API Token**: Useful for headless scripts, CI/CD pipelines, or programmatic API clients.\n\n### Using a Globalping API Token\n\n1. Go to [dash.globalping.io](https://dash.globalping.io) and generate an API token under **Tokens**.\n2. Pass the token via standard HTTP headers:\n\n```json\n{\n \"mcpServers\": {\n \"globalping\": {\n \"url\": \"https://mcp.globalping.dev/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_GLOBALPING_API_TOKEN\"\n }\n }\n }\n}\n```\n\n---\n\n## Programmatic Integration (Anthropic Messages API)\n\nTo use Globalping directly with Anthropic's Messages API (MCP Connector), pass the remote server definition in your request payload:\n\n```json\n{\n \"model\": \"claude-3-7-sonnet-latest\",\n \"max_tokens\": 1024,\n \"mcp_servers\": [\n {\n \"type\": \"url\",\n \"name\": \"globalping\",\n \"url\": \"https://mcp.globalping.dev/mcp\"\n }\n ],\n \"tools\": [\n {\n \"type\": \"mcp_toolset\",\n \"mcp_server_name\": \"globalping\"\n }\n ],\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Run a traceroute to 1.1.1.1 from Frankfurt and Tokyo.\"\n }\n ]\n}\n```\n\n---\n\n## Available Tools\n\n| Tool | Description |\n| --- | --- |\n| `ping` | Perform ICMP/packet ping tests to a destination |\n| `traceroute` | Trace network routing hops to a target |\n| `dns` | Resolve DNS queries using specific resolvers and record types |\n| `mtr` | Run combined ping and traceroute tests (My Traceroute) |\n| `http` | Execute HTTP/HTTPS requests from probes worldwide |\n| `locations` | List available Globalping probe regions and filters |\n| `limits` | Display current API quota and usage limits |\n| `getMeasurement` | Retrieve results of a historical measurement by ID |\n| `compareLocations` | Helper guide to compare multi-region performance metrics |\n| `help` | Tool reference and syntax documentation |\n\n---\n\n## Usage Examples\n\nOnce connected, run network diagnostics using natural language:\n\n```\nPing google.com from 3 locations in Europe\n```\n\n```\nRun a traceroute to github.com from Japan and compare with traceroute from the US\n```\n\n```\nCheck the DNS resolution of example.com using Google DNS (8.8.8.8)\n```\n\n```\nIs jsdelivr.com reachable from China? Test with both ping and HTTP\n```\n\n```\nWhat's the average response time for cloudflare.com across different continents?\n```\n\n---\n\n## Location Specification\n\nLocations can be specified using the location's `magic` parameter:\n\n* **Continents**: `EU`, `NA`, `AS`, `AF`, `OC`, `SA`\n* **Country codes**: `US`, `DE`, `JP`, `PL`, `BR`\n* **Cities**: `London`, `Tokyo`, `New York`, `Warsaw`\n* **Networks & ASNs**: `Cloudflare`, `Google`, `AS13335`, `AS15169`\n* **Cloud regions**: `aws-us-east-1`, `gcp-us-central1`\n* **Combinations**: `London+UK`, `Cloudflare+US`, `AWS+Frankfurt`\n\n---\n\n## Development\n\n```\nsrc/\n├── index.ts # Main entry point & MCP agent definition\n├── app.ts # OAuth web routes\n├── api/ # Globalping API client\n├── auth/ # Authentication helpers\n├── config/ # Configuration & constants\n├── lib/ # Utilities\n├── mcp/ # MCP tool definitions & handlers\n├── types/ # TypeScript interfaces\n└── ui/ # OAuth HTML templates\n```\n\n### Credentials & Secrets\n\nStore OAuth credentials:\n\n```bash\nnpx wrangler secret put GLOBALPING_CLIENT_ID\n```\n\n### KV Storage Setup\n\nFor Cloudflare Workers OAuth state management:\n\n1. Create a KV namespace: `npx wrangler kv:namespace create OAUTH_KV`\n2. Configure `OAUTH_KV` inside `wrangler.jsonc`.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_99":100,"_101":-5,"_102":103,"_104":105,"_106":-5,"_107":108},"requiredSecrets",[],"tags",[98],"assets",[],"stats",{"_96":83,"_97":83},"ratingAvg","reviewCount","remote-mcp-server","topics",[109,110,98],"license","language","TypeScript","registryName","io.globalping/mcp","homepage","packages",[],"mcp","mcp-server","ENV",{"_113":114,"_115":116,"_117":118},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]