Parse a URL
Split a URL into protocol, host, port, path, query parameters (as an object), hash and origin, and report whether the host is an IP address. Use to read query parameters or check a link's host.
Inputs
| Name | Type | Description |
|---|---|---|
url (required) | string | The URL to parse |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/url/parse?url=https%3A%2F%2Fexample.com%3A8080%2Fa%2Fb%3Fx%3D1%26y%3D2%23top"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/url/parse?url=https%3A%2F%2Fexample.com%3A8080%2Fa%2Fb%3Fx%3D1%26y%3D2%23top&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.
Example result
{
"protocol": "https:",
"host": "example.com",
"port": "8080",
"path": "/a/b",
"query": {
"x": "1",
"y": "2"
},
"hash": "#top",
"origin": "https://example.com:8080",
"isIp": false
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is url_parse, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp