The Globalping MCP connector routes your AI agent's tool calls to Globalping's own MCP server through Scalekit. Each user signs in to Globalping once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 12 tools.
- Tools
- 12
- What they doRead · write · destructive
- 12 · 0 · 012 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Globalping MCP connection
In AgentKit > Connections, create a Globalping MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Globalping MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'globalpingmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Globalping MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'globalpingmcp_authstatus',toolInput: { context: 'YOUR_CONTEXT' },})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "globalpingmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Globalping MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={"context":"YOUR_CONTEXT"},tool_name="globalpingmcp_authstatus",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolglobalpingmcp_authstatusCheck the current authentication status with Globalping.Read-onlyAuthStatus
Check the current authentication status with Globalping. Use this tool to verify if the user is logged in and has a valid OAuth token for executing measurements.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
globalpingmcp_comparelocationsGet a guide on how to run comparison tests using the exact same probes as a previous measurement.Read-onlyCompareLocations
Get a guide on how to run comparison tests using the exact same probes as a previous measurement. Use this tool when you need to benchmark different targets from the same vantage points for a fair comparison.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
globalpingmcp_dnsResolve DNS records (A, AAAA, MX, etc.) for a domain from global locations.Read-onlyDns
Resolve DNS records (A, AAAA, MX, etc.) for a domain from global locations. Use this tool to verify DNS propagation, troubleshoot resolution failures, or check if users in different regions are seeing the correct records. Note: Only public endpoints are supported.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
targetstringrequired- Public domain name to resolve (e.g., 'google.com'). Private domains, localhost, and link-local addresses are not supported.
limitnumber- Number of probes to use (default: 3, max: 100).
locationsstring- Locations to run the DNS lookup from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.
queryTypestring- DNS record type to query (default: A).one of
AAAAAANYCNAMEDNSKEYDSHTTPSMXNSNSECPTRRRSIGSOATXTSRVSVCB resolverstring- Custom DNS resolver IP to use (e.g., '1.1.1.1', '8.8.8.8'). Defaults to the probe's system resolver.
traceboolean- Trace the full delegation path from root DNS servers (default: false).
globalpingmcp_get_more_toolsCheck for additional Globalping tools whenever your task might benefit from specialized capabilities — even if existing tools could work as a fallback.Read-onlyGetMoreTools
Check for additional Globalping tools whenever your task might benefit from specialized capabilities — even if existing tools could work as a fallback.
Inputs
contextstringrequired- A description of your goal and what kind of tool would help accomplish it.
globalpingmcp_getmeasurementRetrieve the full details of a past measurement using its ID.Read-onlyGetMeasurement
Retrieve the full details of a past measurement using its ID. Use this tool to access raw JSON data, individual probe results, or cached measurements when the initial summary from a measurement tool is insufficient.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
idstringrequired- The ID of a previously run measurement (e.g., '01HT4DGF5ZS7B2M93QP5ZTS3DN').
globalpingmcp_helpGet a comprehensive guide to the Globalping MCP server.Read-onlyHelp
Get a comprehensive guide to the Globalping MCP server. Use this tool to learn about available tools, understand location formatting (magic fields), or see example usage patterns.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
globalpingmcp_httpSend HTTP/HTTPS requests (GET, HEAD, or OPTIONS) to a URL from global locations.Read-onlyHttp
Send HTTP/HTTPS requests (GET, HEAD, or OPTIONS) to a URL from global locations. Use this tool to check website uptime, verify response status codes, analyze timing (TTFB, download), and debug CDN or caching issues. Note: Only public endpoints are supported. Private networks cannot be tested.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
targetstringrequired- Public domain name or IP address to test (e.g., 'example.com'). Private IPs (RFC1918), localhost, and link-local addresses are not supported.
limitnumber- Number of probes to use (default: 3, max: 100).
locationsstring- Locations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.
methodstring- HTTP method to use (default: GET). Supported: GET, HEAD, OPTIONS.one of
GETHEADOPTIONS pathstring- URL path component (e.g., '/api/v1/status').
portnumber- Port number (default: 443 for HTTPS, 80 for HTTP).
protocolstring- Protocol to use: HTTP or HTTPS (default: HTTPS).one of
HTTPHTTPS querystring- Query string to append to the URL (e.g., 'param=value&another=123').
globalpingmcp_limitsCheck current API rate limits and remaining credits for the Globalping account.Read-onlyLimits
Check current API rate limits and remaining credits for the Globalping account. Use this tool to monitor your usage quota and verify if you can perform additional measurements.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
globalpingmcp_locationsRetrieve the list of available Globalping probe locations.Read-onlyLocations
Retrieve the list of available Globalping probe locations. Use this to find specific countries, cities, or ASNs for the 'locations' argument in measurement tools. Avoid using this unless necessary — the location field in measurement tools auto-selects probes intelligently.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
globalpingmcp_mtrRun an MTR (My Traceroute) diagnostic, which combines Ping and Traceroute.Read-onlyMtr
Run an MTR (My Traceroute) diagnostic, which combines Ping and Traceroute. Use this tool to analyze packet loss and latency trends at every hop in the network path over time, helpful for spotting intermittent issues. Note: Only public endpoints are supported. Private networks cannot be tested.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
targetstringrequired- Public destination hostname or IP address to run the MTR against. Private IPs (RFC1918), localhost, and link-local addresses are not supported.
limitnumber- Number of probes to use (default: 3, max: 100).
locationsstring- Locations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.
packetsnumber- Number of packets to send to each hop (default: 3).
portnumber- Port number for TCP/UDP MTR (default: 80).
protocolstring- Protocol to use for MTR (default: ICMP).one of
ICMPTCPUDP
globalpingmcp_pingMeasure network latency, packet loss, and reachability to a target (domain or IP) from globally distributed probes.Read-onlyPing
Measure network latency, packet loss, and reachability to a target (domain or IP) from globally distributed probes. Use this tool to check if a server is online, debug connection issues, or assess global performance. Note: Only public endpoints are supported. Private networks cannot be tested.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
targetstringrequired- Public domain name or IP address to test (e.g., 'google.com', '1.1.1.1'). Private IPs (RFC1918), localhost, and link-local addresses are not supported.
limitnumber- Number of probes to use (default: 3, max: 100).
locationsstring- Locations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335', or cloud regions like 'Amazon+Germany'. Can also be a previous measurement ID to compare from the same probes.
packetsnumber- Number of packets to send (default: 3).
globalpingmcp_tracerouteTrace the network path to a target (domain or IP) from global locations.Read-onlyTraceroute
Trace the network path to a target (domain or IP) from global locations. Use this tool to identify where packets are being dropped, analyze routing paths, or pinpoint latency sources in the network. Note: Only public endpoints are supported. Private networks cannot be tested.
Inputs
contextstringrequired- Explain why you are calling this tool and how it fits into the user's overall goal. Used for analytics and intent tracking (15-25 words, third-person perspective).
targetstringrequired- Public domain name or IP address to test (e.g., 'cloudflare.com', '1.1.1.1'). Private IPs (RFC1918), localhost, and link-local addresses are not supported.
limitnumber- Number of probes to use (default: 3, max: 100).
locationsstring- Locations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335', or cloud regions like 'Amazon+Germany'. Can also be a previous measurement ID.
portnumber- Port number for TCP/UDP traceroute (default: 80).
protocolstring- Protocol to use for the traceroute (default: ICMP).one of
ICMPTCPUDP
No tools match.
