{
  "name": "url.parse",
  "group": "web",
  "summary": "Parse, normalise or resolve a URL and break out its query parameters.",
  "description": "Decomposes a URL into scheme, host, port, path, query and fragment, decodes every query parameter (keeping repeated keys as arrays), and reports whether the host is an IP address or an IDN. Can also resolve a relative reference against a base URL — the operation that quietly breaks scrapers and link-followers when done with string concatenation.",
  "keywords": [
    "parse url",
    "url components",
    "query string",
    "resolve relative url",
    "hostname",
    "punycode"
  ],
  "endpoint": "https://fluentedi.com/v1/url/parse",
  "mcp_name": "url_parse",
  "makes_network_request": false,
  "parameters": {
    "type": "object",
    "properties": {
      "url": {
        "description": "URL or relative reference to parse.",
        "type": "string",
        "maxLength": 8000,
        "examples": [
          "https://example.com/a/b?q=hello%20world&tag=x&tag=y#top"
        ]
      },
      "base": {
        "description": "Base URL to resolve a relative reference against.",
        "type": "string",
        "default": "",
        "maxLength": 8000
      },
      "strip_tracking": {
        "description": "Also return the URL with utm_* and common click-tracking parameters removed.",
        "type": "boolean",
        "default": false
      }
    },
    "required": [
      "url"
    ],
    "additionalProperties": false
  },
  "examples": [
    {
      "description": "Break a URL into parts",
      "url": "https://fluentedi.com/v1/url/parse?url=https%3A%2F%2Fapi.example.com%3A8443%2Fv1%2Fitems%3Fpage%3D2%26sort%3Dasc%23results",
      "args": {
        "url": "https://api.example.com:8443/v1/items?page=2&sort=asc#results"
      }
    },
    {
      "description": "Resolve a relative link",
      "url": "https://fluentedi.com/v1/url/parse?url=..%2Fimages%2Flogo.png&base=https%3A%2F%2Fexample.com%2Fdocs%2Fguide%2F",
      "args": {
        "url": "../images/logo.png",
        "base": "https://example.com/docs/guide/"
      }
    },
    {
      "description": "Strip campaign parameters",
      "url": "https://fluentedi.com/v1/url/parse?url=https%3A%2F%2Fshop.com%2Fp%2F1%3Futm_source%3Dx%26utm_medium%3Dy%26id%3D9&strip_tracking=true",
      "args": {
        "url": "https://shop.com/p/1?utm_source=x&utm_medium=y&id=9",
        "strip_tracking": true
      }
    }
  ],
  "suggestion": null
}