# CrewHaus — Full Documentation for AI Agents

> AI-powered startup validation & free developer tools

## About CrewHaus

CrewHaus helps founders validate startup ideas with AI research crews, and provides 20 free browser-based tools for developers, designers, and creators. All tools run client-side by default, but we now offer API endpoints for programmatic access by AI agents.

---

## Free Tools — Detailed Descriptions

All tools available at https://crewhaus.ai/tools

### Text Tools

**Word Counter**
- URL: https://crewhaus.ai/tools/word-counter
- API: POST https://crewhaus.ai/api/tools/word-counter
- Description: Paste or type your text to instantly see word count, character count, sentence count, paragraph count, and estimated reading time. Works entirely in your browser — nothing is sent to a server.
- API Example:
  ```
  POST /api/tools/word-counter
  { "input": "Your text here..." }
  → { "words": 3, "characters": 19, "sentences": 1, "paragraphs": 1, "readingTime": "< 1 min" }
  ```

**Case Converter**
- URL: https://crewhaus.ai/tools/case-converter
- API: POST https://crewhaus.ai/api/tools/case-converter
- Description: Instantly convert text between eight common case formats: UPPERCASE, lowercase, Title Case, Sentence case, camelCase, PascalCase, snake_case, and kebab-case. Paste your text and click any format to convert.
- API Example:
  ```
  POST /api/tools/case-converter
  { "input": "hello world", "format": "camel" }
  → { "output": "helloWorld" }
  ```

**Lorem Ipsum Generator**
- URL: https://crewhaus.ai/tools/lorem-ipsum-generator
- API: POST https://crewhaus.ai/api/tools/lorem-ipsum-generator
- Description: Generate lorem ipsum placeholder text for your designs and mockups. Choose between paragraphs, sentences, or individual words, set the count, and copy with one click.
- API Example:
  ```
  POST /api/tools/lorem-ipsum-generator
  { "type": "paragraphs", "count": 2 }
  → { "output": "Lorem ipsum dolor sit amet..." }
  ```

**Text Diff**
- URL: https://crewhaus.ai/tools/text-diff
- API: POST https://crewhaus.ai/api/tools/text-diff
- Description: Paste two versions of any text and instantly see a line-by-line diff. Additions are highlighted in green, deletions in red. Uses the LCS algorithm for accurate results. Runs entirely in your browser.
- API Example:
  ```
  POST /api/tools/text-diff
  { "original": "hello world", "modified": "hello there world" }
  → { "diffs": [{"type": "equal", "value": "hello "}, {"type": "add", "value": "there "}, ...] }
  ```

### Developer Tools

**JSON Formatter**
- URL: https://crewhaus.ai/tools/json-formatter
- API: POST https://crewhaus.ai/api/tools/json-formatter
- Description: Paste raw JSON to format and validate it instantly. Errors are shown with line numbers. Syntax highlighting makes deeply nested structures easy to read. Works entirely client-side.
- API Example:
  ```
  POST /api/tools/json-formatter
  { "input": "{\"key\":\"value\"}" }
  → { "output": "{\n  \"key\": \"value\"\n}", "valid": true }
  ```

**Base64 Encoder / Decoder**
- URL: https://crewhaus.ai/tools/base64-encoder
- API: POST https://crewhaus.ai/api/tools/base64-encoder
- Description: Encode any text to Base64 or decode Base64 back to plain text. Handles Unicode characters correctly. All processing happens in your browser — no data is sent anywhere.
- API Example:
  ```
  POST /api/tools/base64-encoder
  { "input": "hello world", "action": "encode" }
  → { "output": "aGVsbG8gd29ybGQ=" }
  ```

**UUID Generator**
- URL: https://crewhaus.ai/tools/uuid-generator
- API: POST https://crewhaus.ai/api/tools/uuid-generator
- Description: Generate cryptographically random UUID v4 values using your browser's built-in crypto API. Generate one at a time or bulk generate up to 100 UUIDs. Copy any single UUID or all at once.
- API Example:
  ```
  POST /api/tools/uuid-generator
  { "count": 3 }
  → { "uuids": ["550e8400-e29b-41d4-a716-446655440000", ...] }
  ```

**Hash Generator**
- URL: https://crewhaus.ai/tools/hash-generator
- API: POST https://crewhaus.ai/api/tools/hash-generator
- Description: Generate cryptographic hashes from any text input. Supports MD5, SHA-1, SHA-256, and SHA-512 algorithms. Hashes update in real time as you type. All computation happens in your browser.
- API Example:
  ```
  POST /api/tools/hash-generator
  { "input": "hello", "algorithm": "sha256" }
  → { "hash": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824", "algorithm": "sha256" }
  ```

**Regex Tester**
- URL: https://crewhaus.ai/tools/regex-tester
- API: POST https://crewhaus.ai/api/tools/regex-tester
- Description: Enter a regular expression and a test string to see all matches highlighted in real time. Capture groups are listed below the match, with full support for flags like global, case-insensitive, and multiline.
- API Example:
  ```
  POST /api/tools/regex-tester
  { "pattern": "\\d+", "flags": "g", "input": "abc123def456" }
  → { "matches": ["123", "456"], "valid": true }
  ```

**HTML Entity Encoder / Decoder**
- URL: https://crewhaus.ai/tools/html-entity-encoder
- API: POST https://crewhaus.ai/api/tools/html-entity-encoder
- Description: Encode plain text or HTML to HTML entities (< → &lt;) or decode entities back to characters. Supports all named entities and numeric character references including Unicode. Runs in your browser.
- API Example:
  ```
  POST /api/tools/html-entity-encoder
  { "input": "<div>Hello</div>", "action": "encode" }
  → { "output": "&lt;div&gt;Hello&lt;/div&gt;" }
  ```

**URL Encoder / Decoder**
- URL: https://crewhaus.ai/tools/url-encoder
- API: POST https://crewhaus.ai/api/tools/url-encoder
- Description: Encode any string for safe use in a URL, or decode percent-encoded URL components back to readable text. Uses the browser's native encodeURIComponent and decodeURIComponent functions.
- API Example:
  ```
  POST /api/tools/url-encoder
  { "input": "hello world!", "action": "encode" }
  → { "output": "hello%20world%21" }
  ```

**Timestamp Converter**
- URL: https://crewhaus.ai/tools/timestamp-converter
- API: POST https://crewhaus.ai/api/tools/timestamp-converter
- Description: Enter a Unix timestamp to see it converted to ISO 8601, UTC, and local time formats. Shows the current Unix timestamp in real time. Also convert ISO 8601 dates back to Unix timestamps.
- API Example:
  ```
  POST /api/tools/timestamp-converter
  { "input": 1672531200 }
  → { "unix": 1672531200, "iso": "2023-01-01T00:00:00.000Z", "utc": "Sun, 01 Jan 2023 00:00:00 GMT", "local": "12/31/2022, 4:00:00 PM" }
  ```

**JWT Decoder**
- URL: https://crewhaus.ai/tools/jwt-decoder
- API: POST https://crewhaus.ai/api/tools/jwt-decoder
- Description: Paste any JWT token to decode and display the header and payload as formatted JSON. Timestamp fields (exp, iat, nbf) are shown in human-readable format. No signature verification — decode only. Runs entirely in your browser.
- API Example:
  ```
  POST /api/tools/jwt-decoder
  { "input": "eyJhbGc..." }
  → { "header": {...}, "payload": {...}, "valid": true }
  ```

### Security Tools

**Password Generator**
- URL: https://crewhaus.ai/tools/password-generator
- API: POST https://crewhaus.ai/api/tools/password-generator
- Description: Generate cryptographically secure random passwords using your browser's crypto API. Configure length, character sets (uppercase, lowercase, numbers, symbols), and view a real-time strength meter.
- API Example:
  ```
  POST /api/tools/password-generator
  { "length": 16, "uppercase": true, "lowercase": true, "numbers": true, "symbols": true, "count": 3 }
  → { "passwords": ["aB3$xY9...", "mN7&qR2...", ...] }
  ```

### Math Tools

**Percentage Calculator**
- URL: https://crewhaus.ai/tools/percentage-calculator
- API: POST https://crewhaus.ai/api/tools/percentage-calculator
- Description: Three calculation modes in one tool: find X% of a number, calculate what percentage one number is of another, and compute the percentage change between two values. Instant results as you type.
- API Example:
  ```
  POST /api/tools/percentage-calculator
  { "mode": "of", "a": 20, "b": 150 }
  → { "result": 30 }
  ```

### Design Tools (Visual Only)

**Color Picker**
- URL: https://crewhaus.ai/tools/color-picker
- Description: Pick any color and instantly see its HEX, RGB, and HSL values. Generate complementary, analogous, and triadic color palettes. Copy any value to clipboard with one click.
- Note: This is a visual-only tool. No API endpoint available.

**CSS Gradient Generator**
- URL: https://crewhaus.ai/tools/css-gradient-generator
- Description: Pick colors, set the angle, choose linear or radial, and optionally add a midpoint color. See a live preview and copy the ready-to-use CSS background property with one click.
- Note: This is a visual-only tool. No API endpoint available.

### Productivity Tools (Visual Only)

**Markdown Preview**
- URL: https://crewhaus.ai/tools/markdown-preview
- Description: Write or paste markdown on the left and see a live HTML preview on the right. Supports headings, bold, italic, code blocks, lists, links, images, and blockquotes. Everything runs in your browser.
- Note: This is a visual-only tool. No API endpoint available.

**Pomodoro Timer**
- URL: https://crewhaus.ai/tools/pomodoro-timer
- Description: A clean Pomodoro timer with customizable work and break durations. Tracks completed sessions, plays an audio notification when each phase ends, and works entirely in your browser with no accounts or installs.
- Note: This is a visual-only tool. No API endpoint available.

**Invoice Generator**
- URL: https://crewhaus.ai/tools/invoice-generator
- Description: Fill in your company details, client info, and line items to generate a professional invoice. Add tax, set the currency, and print directly to PDF using your browser's built-in print dialog. No account required.
- Note: This is a visual-only tool. No API endpoint available.

---

## API Usage

### Authentication
No authentication required. All tool endpoints are public and free to use.

### Rate Limiting
60 requests per minute per IP address (enforced by Vercel).
Response header: `X-RateLimit: 60/minute`

### Response Format
All API responses include HATEOAS links:
```json
{
  "output": "...",
  "_links": {
    "self": "https://crewhaus.ai/api/tools/{slug}",
    "docs": "https://crewhaus.ai/api/tools/openapi.json"
  }
}
```

### Error Handling
- 400: Invalid input or visual-only tool
- 405: Method not allowed (use POST)
- 500: Server error

---

## Startup Validation API

**AI Idea Scorecard**
- Endpoint: POST https://crewhaus.ai/api/score
- Description: FREE instant AI-powered startup idea scoring across 5 dimensions
- Example:
  ```
  POST /api/score
  { "email": "agent@example.com", "idea": "AI meal planning for diabetics", "customer": "Adults 30-65 with diabetes" }
  → { "overall": 76, "topDimension": {...}, "summary": "...", "competitors": [...] }
  ```

**Full Validation Services**
- Signal Check: $29 — Deep market viability assessment
- Deep Dive: $149 — Comprehensive market research report
- Build Sprint: $799 — Full product sprint with 9-agent crew

Portal: https://certify.crewhaus.ai

---

## Contact

- Web: https://crewhaus.ai
- Email: crew@crewhaus.ai
- Twitter/X: @crewhaus
- Documentation: https://crewhaus.ai/docs