Skip to main content
Glama

parse_url

Read-onlyIdempotent

utilpeek: parse a URL. To fetch the page use render_page. The URL is parsed, never fetched. Public-suffix split from the Public Suffix List snapshot bundled with the parser (dated 2025-04-07; suffixes added later are not known), with and without the PSL private section; credentials in the URL are never echoed. A URL that cannot be parsed is a 422 (not charged). Typically under 0.1 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day. Docs: https://tanod.dev/learn/url-parser-api.html

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "url": "<url>"
    },
    "name": "parse_url"
  }
}

Input Schema

NameRequiredDescriptionDefault
urlYesURL to parse (never fetched).

Output Schema

NameRequiredDescriptionDefault
hostNo
pathNo
portNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
is_ipNo
queryNo
paramsNo
schemeNo
sourceNo
fragmentNo
usernameNo
subdomainNo
host_asciiNo
idna_validNo
ip_versionNo
normalizedNo
domain_labelNo
has_passwordNo
host_scriptsNo
host_unicodeNo
icann_suffixNo
known_suffixNo
path_segmentsNo
public_suffixNo
effective_portNo
scheme_assumedNo
params_truncatedNo
suffix_is_privateNo
mixed_script_labelNo
registrable_domainNo
path_segments_truncatedNo
icann_registrable_domainNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • removedInput schema / properties / url / title
      Removed value: -"Url"
    • removedInput schema / title
      Removed value: -"parse_urlArguments"
    • removedOutput schema / properties / host_scripts / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / params / items
      Removed value: -{
      -  "items": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "type": [
      -    "array",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / path_segments / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / source / properties
      Removed value: -{
      -  "library": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "license": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "url": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "domain_label": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "effective_port": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "fragment": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "has_password": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "host": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "host_ascii": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "host_scripts": {
      +      "items": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "host_unicode": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "icann_registrable_domain": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "icann_suffix": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "idna_valid": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "ip_version": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "is_ip": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "known_suffix": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "mixed_script_label": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "normalized": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "params": {
      +      "items": {
      +        "items": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "type": [
      +          "array",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "params_truncated": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "path": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "path_segments": {
      +      "items": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "path_segments_truncated": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "port": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "public_suffix": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "query": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "registrable_domain": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "scheme": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "scheme_assumed": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "source": {
      +      "properties": {
      +        "library": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "subdomain": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "suffix_is_private": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "username": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources