Skip to content
MCP server

YourSUUID

Generate UUID v4, v5 and v7, ULID and NanoID values and inspect UUIDs, with dev utilities

Install
Pricing
Open source
Platforms
CLI, API, Web
Runs
Locally or Remotely
Version
1.0.0
Listing updated
2 days ago

About YourSUUID

YourSUUID is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://yoursuuid.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (23)

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

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

What it does

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

Pricing

Open source

MIT licensed; REST API has a free tier and paid plans with higher quotas

Prices change. Check yoursuuid.com before you buy.

YourSUUID 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 to YourSUUID

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools