Skip to content
MCP server

Uuid

Offline UUID validator and parser plus v4 generator for developers and AI agents

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Uuid

Uuid is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/uuid/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "uuid": {
      "url": "https://gateway.pipeworx.io/uuid/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for higher usage.

Prices change. Check pipeworx.io before you buy.

Uuid 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.

How AIPoweredBot checks servers