Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Globalping MCP server

Vendor MCP
Open markdown

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 app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  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. Create the Globalping MCP connection

    In AgentKit > Connections, create a Globalping MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Globalping MCP server, so you don't need to register an OAuth app.

  4. 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.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)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'globalpingmcp_authstatus',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • globalpingmcp_authstatusCheck the current authentication status with Globalping.Read-only

    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.

    Inputs

    This tool takes no inputs.

  • globalpingmcp_comparelocationsGet a guide on how to run comparison tests using the exact same probes as a previous measurement.Read-only

    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.

    Inputs

    This tool takes no inputs.

  • globalpingmcp_dnsResolve DNS records (A, AAAA, MX, etc.) for a domain from global locations.Read-only

    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.

    Inputs

    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). Higher limits provide more diverse results when using 'world' location.
    locationsstring
    Specific locations to run the test from using the Globalping magic field syntax. Use 'world' to select a diverse set of probes globally. It supports Globalping magic field syntax: ['US', 'Europe', 'AS13335', 'London+UK', 'Amazon+Germany', 'Greece']. You can also use a previous measurement ID to compare results with the same probes.
    queryTypestring
    DNS record type (default: A)one of AAAAAANYCNAMEDNSKEYDSHTTPSMXNSNSECPTRRRSIGSOATXTSRVSVCB
    resolverstring
    Custom resolver to use (e.g., '1.1.1.1', '8.8.8.8')
    traceboolean
    Trace delegation path from root 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-only

    GetMoreTools

    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-only

    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.

    Inputs

    idstringrequired
    The ID of a previously run measurement (e.g., '01HT4DGF5ZS7B2M93QP5ZTS3DN')
  • globalpingmcp_helpGet a comprehensive guide to the Globalping MCP server.Read-only

    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.

    Inputs

    This tool takes no inputs.

  • globalpingmcp_httpSend HTTP/HTTPS requests (GET, HEAD, or OPTIONS) to a URL from global locations.Read-only

    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.

    Inputs

    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). Higher limits provide more diverse results when using 'world' location.
    locationsstring
    Specific locations to run the test from using the Globalping magic field syntax. Use 'world' to select a diverse set of probes globally. It supports Globalping magic field syntax: ['US', 'Europe', 'AS13335', 'London+UK', 'Amazon+Germany', 'Greece']. You can also use a previous measurement ID to compare results with the same probes.
    methodstring
    HTTP method (default: GET)one of GETHEADOPTIONS
    pathstring
    Path component of the URL (e.g., '/api/v1/status')
    portnumber
    Port number (default: 443 for HTTPS, 80 for HTTP)
    protocolstring
    Protocol to use (default: HTTPS)one of HTTPHTTPS
    querystring
    Query string (e.g., 'param=value&another=123')
  • globalpingmcp_limitsCheck current API rate limits and remaining credits for the Globalping account.Read-only

    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.

    Inputs

    This tool takes no inputs.

All 30 in Monitoring