Developer Documentation

REST API

The Dev Tools ! REST API provides programmatic access to 65+ developer tools. All endpoints follow the JSON API conventions and return consistent response shapes.

Base URL

https://api.devtoolzy.com/devtoolzy/api

Endpoints

Example: Run a tool

curl -X POST https://api.devtoolzy.com/devtoolzy/api/tools/uuid-generator/run \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 5}'

{
  "ok": true,
  "result": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "c3d4e5f6-a7b8-9012-cdef-012345678902",
    "d4e5f6a7-b8c9-0123-def0-123456789003",
    "e5f6a7b8-c9d0-1234-ef01-234567890004"
  ]
}

Example: List tools

curl https://api.devtoolzy.com/devtoolzy/api/tools

{
  "ok": true,
  "tools": [
    {
      "slug": "uuid-generator",
      "name": "UUID Generator",
      "category": "generators",
      "description": "Generate version 4 and version 7 UUIDs",
      "url": "https://devtoolzy.com/tools/generators/uuid-generator"
    }
    // ... 64 more tools
  ]
}

Authentication

Read endpoints (GET /tools, GET /flags, GET /health) are open — no authentication required. Write and execute endpoints require an API key.

Passing the API Key

# Header (recommended)
curl https://api.devtoolzy.com/devtoolzy/api/tools/base64/run \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello, World!", "mode": "encode"}'

MCP Server

The Model Context Protocol (MCP) server exposes all Dev Tools ! functions as typed tool calls to any MCP-compatible AI client: Claude Desktop, Cursor, Continue, Zed, and more.

Connection

// Claude Desktop — ~/Library/Application\ Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "devtoolzy": {
      "command": "npx",
      "args": ["-y", "@cosyslabs/devtoolzy-mcp"]
    }
  }
}

Alternative: HTTP transport (remote)

{
  "mcpServers": {
    "devtoolzy": {
      "url": "https://devtoolzy.com/devtoolzy/mcp",
      "transport": "streamable-http"
    }
  }
}

Available MCP tools (sample)

Full MCP documentation →

npm CLI

Run any Dev Tools ! function directly from the terminal via npx — no installation required.

Usage

# No install needed
npx devtoolzy <tool> [options]

# Examples
npx devtoolzy uuid --count 5 --version 7
npx devtoolzy hash --algorithm sha256 --input "Hello, World!"
npx devtoolzy base64 encode "Hello, World!"
npx devtoolzy jwt decode eyJhbGciOiJSUzI1NiJ9...
npx devtoolzy cron explain "0 9 * * 1-5"
npx devtoolzy timestamp 2026-01-01T00:00:00Z

Install globally

npm install -g devtoolzy

# Then use without npx
devtoolzy uuid
devtoolzy --help

VS Code Extension

The Dev Tools ! VS Code extension brings the full tool palette into the editor. Run tools from the command palette (Ctrl/Cmd + Shift + P), use the sidebar panel, or invoke tools from the context menu on selected text.

Install

code --install-extension cosyslabs.devtoolzy

Features

• 65+ tools accessible from command palette
• Right-click selection → encode/decode/hash/format
• Sidebar panel with categories and search
• Output sent to a new editor tab or inline replacement
• Settings: preferred hash algorithm, UUID version, output format

Extension commands (sample)

DevTools: Encode selection as Base64
DevTools: Decode Base64 selection
DevTools: Format JSON
DevTools: Generate UUID
DevTools: Hash selection (SHA-256)
DevTools: Decode JWT
DevTools: Open Tool Palette

SDK & Integrations

Integrate Dev Tools ! functions directly into your Node.js or Python projects using the core packages.

JavaScript / TypeScript

npm install @cosyslabs/devtoolzy-core

import { base64, uuid, hash, jwt } from '@cosyslabs/devtoolzy-core';

// Base64
const encoded = base64.encode('Hello, World!');
const decoded = base64.decode(encoded);

// UUID
const id = uuid.v4();
const sortableId = uuid.v7();

// Hashing
const sha256 = await hash.sha256('Hello, World!');
const sha512 = await hash.sha512('Hello, World!');

// JWT
const { header, payload } = jwt.decode(token); // no verification

Python

pip install devtoolzy

from devtoolzy import base64_encode, base64_decode, uuid_v7, sha256

encoded = base64_encode("Hello, World!")
decoded = base64_decode(encoded)
unique_id = uuid_v7()
digest = sha256("Hello, World!")

Rate Limits

Rate limit headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1751400060

When the rate limit is exceeded, the API returns HTTP 429 Too Many Requests with a Retry-After header.

Errors

All error responses follow the same shape:

{
  "ok": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "input must be a non-empty string",
    "field": "input"
  }
}