Globalping MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. 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>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'globalpingmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Globalping MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'globalpingmcp_get_more_tools',
     toolInput: { context: 'YOUR_CONTEXT' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "globalpingmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={"context":"YOUR_CONTEXT"},
       tool_name="globalpingmcp_get_more_tools",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Traceroute records — Trace the network path to a target (domain or IP) from global locations
• Ping records — Measure network latency, packet loss, and reachability to a target (domain or IP) from globally distributed probes
• Mtr records — Run an MTR (My Traceroute) diagnostic, which combines Ping and Traceroute
• Locations records — Retrieve the list of available Globalping probe locations
• Limits records — Check current API rate limits and remaining credits for the Globalping account
• Http records — Send HTTP/HTTPS requests (GET, HEAD, or OPTIONS) to a URL from global locations

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

globalpingmcp_authstatus#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.1 param▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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_comparelocations#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.1 param▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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_dns#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.7 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

targetstringrequiredPublic domain name to resolve (e.g., 'google.com'). Private domains, localhost, and link-local addresses are not supported.

limitnumberoptionalNumber of probes to use (default: 3, max: 100).

locationsstringoptionalLocations to run the DNS lookup from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.

queryTypestringoptionalDNS record type to query (default: A).

resolverstringoptionalCustom DNS resolver IP to use (e.g., '1.1.1.1', '8.8.8.8'). Defaults to the probe's system resolver.

tracebooleanoptionalTrace the full delegation path from root DNS servers (default: false).

globalpingmcp_get_more_tools#Check for additional Globalping tools whenever your task might benefit from specialized capabilities — even if existing tools could work as a fallback.1 param▾

Check for additional Globalping tools whenever your task might benefit from specialized capabilities — even if existing tools could work as a fallback.

NameTypeRequiredDescription

contextstringrequiredA description of your goal and what kind of tool would help accomplish it.

globalpingmcp_getmeasurement#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.2 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

idstringrequiredThe ID of a previously run measurement (e.g., '01HT4DGF5ZS7B2M93QP5ZTS3DN').

globalpingmcp_help#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.1 param▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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_http#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.9 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

targetstringrequiredPublic domain name or IP address to test (e.g., 'example.com'). Private IPs (RFC1918), localhost, and link-local addresses are not supported.

limitnumberoptionalNumber of probes to use (default: 3, max: 100).

locationsstringoptionalLocations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.

methodstringoptionalHTTP method to use (default: GET). Supported: GET, HEAD, OPTIONS.

pathstringoptionalURL path component (e.g., '/api/v1/status').

portnumberoptionalPort number (default: 443 for HTTPS, 80 for HTTP).

protocolstringoptionalProtocol to use: HTTP or HTTPS (default: HTTPS).

querystringoptionalQuery string to append to the URL (e.g., 'param=value&another=123').

globalpingmcp_limits#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.1 param▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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_locations#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.1 param▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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_mtr#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.7 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

targetstringrequiredPublic destination hostname or IP address to run the MTR against. Private IPs (RFC1918), localhost, and link-local addresses are not supported.

limitnumberoptionalNumber of probes to use (default: 3, max: 100).

locationsstringoptionalLocations to run the test from. Supports Globalping magic field syntax: 'world', country codes like 'US', city names like 'London+UK', ASNs like 'AS13335'.

packetsnumberoptionalNumber of packets to send to each hop (default: 3).

portnumberoptionalPort number for TCP/UDP MTR (default: 80).

protocolstringoptionalProtocol to use for MTR (default: ICMP).

globalpingmcp_ping#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.5 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

targetstringrequiredPublic 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.

limitnumberoptionalNumber of probes to use (default: 3, max: 100).

locationsstringoptionalLocations 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.

packetsnumberoptionalNumber of packets to send (default: 3).

globalpingmcp_traceroute#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.6 params▾

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.

NameTypeRequiredDescription

contextstringrequiredExplain 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).

targetstringrequiredPublic 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.

limitnumberoptionalNumber of probes to use (default: 3, max: 100).

locationsstringoptionalLocations 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.

portnumberoptionalPort number for TCP/UDP traceroute (default: 80).

protocolstringoptionalProtocol to use for the traceroute (default: ICMP).