# Uuid

> Uuid is a freemium MCP server for developer tools. Offline UUID validator and parser plus v4 generator for developers and 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/uuid
- **Repository:** https://github.com/pipeworx-io/mcp-uuid
- **MCP Registry name:** io.github.pipeworx-io/uuid
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a UUID validation and generation server that runs through the Pipeworx MCP gateway. Its validate_uuid tool checks a UUID's format and reports its version, variant, and whether it is the nil or max value, and for time-based versions (v1 and v7) it also decodes the embedded timestamp as an ISO date. A separate generate_uuid tool produces one or more random v4 identifiers.

The package is a local stdio bridge that forwards calls to a hosted endpoint, so network access is required even though the validation logic itself is described as offline. Without an API key calls are anonymous and capped daily; a free Pipeworx account raises the cap, and the README notes that metering and billing apply the same way as on the hosted connection.

It suits developers and agent builders who want UUID checks and generation available as tools inside an MCP client such as Claude Desktop, Cursor, or Claude Code, without writing parsing code themselves.

## Features

- **UUID format validation:** Checks whether a string is a well-formed UUID and reports its version and variant.
- **Timestamp extraction:** Decodes the embedded time from v1 and v7 UUIDs and returns it as an ISO date.
- **Nil and max detection:** Flags whether a given UUID is the all-zero nil value or the all-ones max value.
- **Random v4 generation:** Creates one or more random version 4 UUIDs in a single call.
- **Stdio and remote transports:** Runs locally via npx or connects directly to a streamable HTTP endpoint.

## Good for

- Checking that identifiers received from an API or user input are valid UUIDs
- Recovering the creation time embedded in v1 or v7 identifiers during debugging
- Generating v4 UUIDs for test fixtures or seed data from inside an AI assistant
- Adding UUID handling to an agent workflow without writing custom parsing code

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `validate_uuid`: Validate and parse a UUID, returning version, variant, nil/max status, and embedded timestamp for v1/v7.
- `generate_uuid`: Generate one or more random v4 UUIDs.

## FAQ

### Does validation work without a network connection?

The README says validate_uuid is keyless and offline, but the npm bridge forwards every call to the hosted gateway and has no offline mode, so network access is needed when using it that way.

### Do I need an API key?

No. Calls without a key are anonymous and capped at 50 per day. A free account raises the cap to 200 per day.

### Which UUID versions can be parsed for timestamps?

The listing states that the embedded timestamp is returned for time-based versions v1 and v7.

### Is Uuid free?

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

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

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

### What are the best alternatives to Uuid?

The closest alternatives to Uuid are Ulid, YourSUUID, UUID Mint, Buildutilities MCP and Random UUID v4.

## 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

- [Ulid](https://ai-powered.com/mcp/ulid): Ulid is a freemium MCP server for developer tools.
- [YourSUUID](https://ai-powered.com/mcp/yoursuuid): YourSUUID is an open-source MCP server for developer tools.
- [UUID Mint](https://ai-powered.com/mcp/uuid-mint): UUID Mint is a free MCP server for developer tools.
- [Buildutilities MCP](https://ai-powered.com/mcp/buildutilities-mcp): Buildutilities MCP is an open-source MCP server for developer tools.
- [Random UUID v4](https://ai-powered.com/mcp/random-uuid-v4): Random UUID v4 is an MCP server for developer tools.
- [UUID no-hyphen 32-hex, value discarded](https://ai-powered.com/mcp/uuid-no-hyphen-32-hex-value-discarded): UUID no-hyphen 32-hex, value discarded is an open-source MCP server for developer tools.
- [devutils](https://ai-powered.com/mcp/devutils-2): devutils is a free MCP server for developer tools.
- [Json](https://ai-powered.com/mcp/json): Json is a freemium MCP server for developer tools.

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