`build_url`

Pack: url · Endpoint: https://gateway.pipeworx.io/url/mcp

Build a URL string from components. Provide at least hostname (and optionally protocol, port, path, hash) plus a query object of key/value pairs.

Parameters

Name	Type	Required	Description
`protocol`	string	no	e.g. “https” (default).
`hostname`	string	yes	Host, e.g. “example.com”.
`port`	number	no	Optional port.
`path`	string	no	Path, e.g. “/search” (default ”/”).
`query`	object	no	Query parameters as an object, e.g. {“q”:“cats”,“page”:2}.
`hash`	string	no	Optional fragment (without ”#”).

Example call

Arguments

{
  "hostname": "example.com",
  "protocol": "https",
  "path": "/search",
  "query": {
    "q": "cats",
    "page": 2
  }
}

curl

curl -X POST https://gateway.pipeworx.io/url/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"build_url","arguments":{"hostname":"example.com","protocol":"https","path":"/search","query":{"q":"cats","page":2}}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('build_url', {
  "hostname": "example.com",
  "protocol": "https",
  "path": "/search",
  "query": {
    "q": "cats",
    "page": 2
  }
});

More examples

{
  "hostname": "api.example.com",
  "port": 8443,
  "path": "/v1/users",
  "query": {
    "limit": 10
  },
  "hash": "results"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "url": {
      "url": "https://gateway.pipeworx.io/url/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

build_url