# YourSUUID

> YourSUUID is an open-source MCP server for developer tools. Generate UUID v4, v5 and v7, ULID and NanoID values and inspect UUIDs, with dev utilities. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web
- **Website:** https://yoursuuid.com/uuid-api
- **Repository:** https://github.com/sohan724code/yoursuuid/tree/HEAD/packages/yoursuuid
- **MCP Registry name:** io.github.sohan724code/yoursuuid
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

The server runs locally through npx and gives an assistant identifier tools without relying on a model to invent random-looking values. Randomness comes only from crypto.getRandomValues, and UUID v7 and ULID are monotonic within a process, so IDs made in the same millisecond still sort in creation order. inspect_uuid returns validity, version, variant and the embedded timestamp.

The tool list goes well beyond IDs: HMAC, JWT signing and verification, bcrypt hash and verify, base32 and base58, JSON to TypeScript, Zod, Go or Rust types, SQL formatting, curl to code, cron next-run calculation and building, regex and chmod explanations, and docker run to Compose conversion.

A hosted Streamable HTTP endpoint at yoursuuid.com/mcp offers only the identifier tools; HMAC, JWT and bcrypt stay on the local server so secrets never leave your machine. The same package is a zero-dependency library and CLI for Node 20+, browsers, Deno, Bun and edge runtimes, under the MIT licence. The site also runs a REST API where anonymous use allows 60 requests a minute and 2,000 a day, and a free key allows 10,000 a day.

## Features

- **UUID generation:** UUID v4, v5 and v7 with monotonic ordering for v7.
- **ULID and NanoID:** Generate ULIDs and NanoIDs with custom size.
- **UUID inspection:** Check validity, version, variant and timestamp.
- **Crypto helpers:** HMAC, JWT and bcrypt tools run locally.
- **Code converters:** JSON to TypeScript, Zod, Go and Rust, plus curl to code.
- **Cron and ops helpers:** Next cron runs, cron builder, chmod and docker run to Compose.

## Good for

- Create time-ordered UUID v7 keys for a database seed
- Decode the version and timestamp of an unfamiliar UUID
- Convert a JSON payload into TypeScript or Zod types
- See the next five runs of a cron expression
- Generate a deterministic v5 UUID from a name

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http yoursuuid https://yoursuuid.com/mcp
```

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

```sh
https://yoursuuid.com/mcp
```

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

```json
{
  "mcpServers": {
    "yoursuuid": {
      "url": "https://yoursuuid.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "yoursuuid": {
      "type": "http",
      "url": "https://yoursuuid.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yoursuuid": {
      "serverUrl": "https://yoursuuid.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "yoursuuid": {
      "type": "http",
      "url": "https://yoursuuid.com/mcp"
    }
  }
}
```

## Tools

- `generate_uuid`: Generate UUIDs
- `generate_uuid_v5`: Generate a name-based v5 UUID
- `generate_ulid`: Generate ULIDs
- `generate_nanoid`: Generate NanoIDs
- `inspect_uuid`: Inspect a UUID's version, variant and timestamp
- `hmac`: Compute an HMAC
- `jwt_sign`: Sign a JWT
- `jwt_verify`: Verify a JWT
- `bcrypt_hash`: Hash with bcrypt
- `bcrypt_verify`: Verify a bcrypt hash
- `base58`: Base58 encode or decode
- `base32`: Base32 encode or decode
- `json_to_typescript`: Convert JSON to TypeScript types
- `json_to_zod`: Convert JSON to a Zod schema
- `json_to_go`: Convert JSON to Go types
- `json_to_rust`: Convert JSON to Rust types
- `format_sql`: Format SQL
- `curl_to_code`: Convert curl to code
- `cron_next_runs`: Next runs of a cron expression
- `build_cron`: Build a cron expression
- `explain_regex`: Explain a regex
- `explain_chmod`: Explain chmod permissions
- `docker_run_to_compose`: Convert docker run to Compose

## FAQ

### How do I run it locally?

Add npx -y yoursuuid mcp as a stdio MCP server.

### Is there a hosted version?

Yes, https://yoursuuid.com/mcp, which offers only the identifier tools so secrets stay local.

### What licence is the package?

MIT.

### Are the IDs cryptographically random?

The package uses crypto.getRandomValues; the REST API uses the operating system CSPRNG.

### Are the REST API limits free?

Anonymous use allows 60 requests a minute and 2,000 a day; a free key allows 10,000 a day.

### Is YourSUUID free?

Yes. YourSUUID is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add --transport http yoursuuid https://yoursuuid.com/mcp

### What are the best alternatives to YourSUUID?

The closest alternatives to YourSUUID are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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