# Url

> Url is a freemium MCP server for developer tools. Parse, build and split URLs and query strings as MCP tools for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/url
- **Repository:** https://github.com/pipeworx-io/mcp-url
- **MCP Registry name:** io.github.pipeworx-io/url
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says this is a URL parsing and building server, published as one pack on the Pipeworx MCP gateway. It exposes three tools: one breaks a URL into protocol, host, port, path, query object, fragment, origin and userinfo; one assembles a URL from components plus a query object; and one turns a query string into an object, collecting repeated keys into arrays. The parsing and building steps run without any upstream lookup, so they do not depend on an external data source.

The server can be reached in two ways: a hosted streamable-HTTP endpoint on the Pipeworx gateway, or a local npm stdio bridge that forwards calls to that same endpoint and therefore needs network access. The npm package lists only this pack's tools by default. The gateway also exposes shared meta-tools such as ask_pipeworx alongside the pack's own tools.

It suits developers and agent builders who want an assistant to handle URL manipulation without writing parsing code themselves.

## Features

- **Full URL decomposition:** Splits a URL into protocol, host, hostname, port, path, parsed query, fragment, origin and userinfo.
- **URL construction from parts:** Builds a URL string from a hostname plus optional protocol, port, path and hash, with a query object.
- **Query string parsing:** Turns a query string, with or without a leading question mark, into an object and groups repeated keys as arrays.
- **Hosted and local connection options:** Available as a remote streamable-HTTP endpoint or as a local npm stdio bridge.
- **Optional API key:** Anonymous use is rate-limited daily; an optional Pipeworx key raises the cap.

## Good for

- Splitting a logged URL into its host, path and query parameters for debugging
- Constructing links with encoded query parameters from a set of components
- Normalising query strings from incoming requests into key-value objects
- Letting an AI assistant inspect or rebuild URLs while working in an MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http url https://gateway.pipeworx.io/url/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/url/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "url": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/url/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "url": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/url/mcp"
    }
  }
}
```

## Tools

- `parse_url`: Parse a URL into its components (keyless, offline): protocol, host, hostname, port, path, query (as an object), fragment, origin, and any userinfo.
- `build_url`: Build a URL string from components. Provide at least hostname plus optional protocol, port, path, hash and a query object.
- `parse_query`: Parse a query string (with or without a leading "?") into an object; repeated keys become arrays.

## FAQ

### Does the URL parsing need an internet connection?

The README says the parse tool is keyless and offline, but the npm bridge forwards every call to the gateway and needs network access, and there is no offline mode.

### Is an API key required?

No. The registry and README say calls are anonymous without a key and capped daily; a free key raises the daily limit.

### Does the server list only the three URL tools?

The hosted endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx. The npm package lists only this pack's tools unless PIPEWORX_META_TOOLS=1 is set.

### Is Url free?

Url has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Url to Claude Code?

Run this command in your terminal: claude mcp add --transport http url https://gateway.pipeworx.io/url/mcp

### What are the best alternatives to Url?

The closest alternatives to Url are Json, Markdown, Httpbin, Unicode and Httpstatus.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Json](https://ai-powered.com/mcp/json): Json is a freemium MCP server for developer tools.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.
- [Httpbin](https://ai-powered.com/mcp/httpbin): Httpbin is a freemium MCP server for developer tools.
- [Unicode](https://ai-powered.com/mcp/unicode): Unicode is a freemium MCP server for developer tools.
- [Httpstatus](https://ai-powered.com/mcp/httpstatus): Httpstatus is a freemium MCP server for developer tools.
- [Dns](https://ai-powered.com/mcp/dns-2): Dns is a freemium MCP server for developer tools.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [Ipaddress](https://ai-powered.com/mcp/ipaddress): Ipaddress is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/url
