# Cuelark Tools MCP server

A free, remote [Model Context Protocol](https://modelcontextprotocol.io) server with exact, deterministic text and data tools for AI assistants: JSON formatting and conversion, OpenAI token counts, cron schedules, date and age maths with exam cut-offs, word counts, CGPA conversion with official university formulas, time zones with daylight saving, print sizes and a lookup for the [Cuelark UI](https://ui.cuelark.com) shadcn registry.

- **URL:** `https://tools.cuelark.com/mcp`
- **Transport:** Streamable HTTP (JSON responses, stateless)
- **Auth:** none · **Price:** free · **Rate limit:** 600 requests per minute per IP
- **Docs:** https://tools.cuelark.com/mcp

The same tools run as web pages, in the browser, at [tools.cuelark.com](https://tools.cuelark.com).

## Install

### Claude (claude.ai and Claude Desktop)

Settings → Connectors → **Add custom connector** → paste `https://tools.cuelark.com/mcp`.

### Claude Code

```bash
claude mcp add --transport http cuelark-tools https://tools.cuelark.com/mcp
```

### Cursor

`~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):

```json
{
  "mcpServers": {
    "cuelark-tools": { "url": "https://tools.cuelark.com/mcp" }
  }
}
```

### VS Code (GitHub Copilot agent mode)

`.vscode/mcp.json`:

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

### stdio-only clients

```bash
npx -y mcp-remote https://tools.cuelark.com/mcp
```

## Tools

| Tool | What it does |
| --- | --- |
| `json_format` | Validate JSON and return it pretty-printed or minified, optionally with keys sorted. Errors give line and column. |
| `json_convert` | Convert between JSON and YAML (JSON → YAML) or CSV (both directions; CSV needs a header row, JSON needs an array of objects). |
| `count_tokens` | Exact OpenAI token counts (o200k_base for GPT-4o/4.1/5 and o-series, cl100k_base for GPT-4/3.5) plus labelled estimates for Claude and Gemini. |
| `cron_explain` | Describe a cron expression in plain English and list its next run times in an IANA time zone. Accepts 5-field cron, @daily-style macros and pasted crontab lines. |
| `date_calculate` | Days between two dates (with years/months/days and working days), or add/subtract days, weeks, months, years or working days. Month ends clamp (31 Jan + 1 month = 28/29 Feb). |
| `age_calculate` | Exact age in years, months and days on a date, and eligibility against an age limit ("attained min, not attained max"). Built-in exam presets from official notices: upsc-cse-2026 (UPSC Civil Services 2026), ssc-chsl-2025 (SSC CHSL 2025). |
| `text_count` | Count words (Unicode word rules, works for Japanese/Chinese/Hindi), characters as graphemes, sentences, paragraphs, reading time, X/Twitter weighted length, SMS segments, and platform limits. |
| `cgpa_convert` | Convert CGPA to percentage or back using only formulas the board or university publishes: cbse (Percentage = 9.5 × CGPA); vtu (Percentage = (CGPA − 0.75) × 10); anna (Percentage = CGPA × 10). Each result cites the source. |
| `timezone_convert` | Convert a wall-clock date and time from one IANA time zone to another with daylight saving for that date, and report each zone's next clock change. |
| `print_size` | Convert between pixels and physical size at a DPI: pixels → print size (mm/cm/in), or physical size → pixels needed. |
| `ui_component_lookup` | Search the ui.cuelark.com shadcn/ui registry (React components, blocks and themes) and get the shadcn CLI install command for each match. |

All tools are read-only and return both text and `structuredContent`.

## Example prompts

- "Am I eligible for UPSC CSE 2026 if I was born on 3 March 1995?"
- "What is 4 pm IST on 12 March 2027 in New York?"
- "Explain `*/15 9-17 * * MON-FRI` in Asia/Kolkata and show the next 5 runs."
- "Convert a VTU CGPA of 7.8 to a percentage."
- "Turn this JSON array into CSV."
- "Find a Cuelark UI component for a pricing table and give me the install command."

## Sources for official formulas

- **CGPA:** CBSE (9.5 × CGPA, CCE certificate), VTU ((CGPA − 0.75) × 10, vtu.ac.in), Anna University R2021 (CGPA × 10, clause 15.5.3). Universities without a published, readable formula are left out on purpose.
- **Exam age limits:** UPSC CSE 2026 (21–32 on 1 Aug 2026) and SSC CHSL 2025 (18–27 on 1 Jan 2026), from the official notices. General category only; relaxations are not applied.

## Privacy

- Inputs and outputs are not logged or stored. There are no sessions.
- Text and numbers only. There are deliberately no image or PDF tools: those run only in the browser at tools.cuelark.com, so files never leave the user's device.
- The rate limiter counts requests per IP and keeps no request content.

## Protocol notes

- Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.
- Methods: `initialize`, `ping`, `tools/list`, `tools/call`, `resources/list`, `prompts/list` and notifications. JSON-RPC batches of up to 20 messages; bodies up to 1 MB.
- `GET /mcp` with `Accept: text/event-stream` returns 405 (no server-initiated stream). A browser `GET` shows the docs page.

## Test it

```bash
npx @modelcontextprotocol/inspector --cli https://tools.cuelark.com/mcp --transport http --method tools/list
npx @modelcontextprotocol/inspector --cli https://tools.cuelark.com/mcp --transport http \
  --method tools/call --tool-name cgpa_convert --tool-arg scheme=vtu --tool-arg cgpa=7.8
```

## License

MIT © Cuelark