# GO AI Tools — hosted MCP server

> A public, hosted Model Context Protocol server exposing 31 deterministic developer and everyday tools over streamable HTTP. Image conversion, App Store assets, colour maths, and calculators. No API key, no account, no signup — every tool is plain computation, so no AI model is ever invoked and there is nothing to bill.

These are the same tools that run at [/tools](https://goaichat.app/tools) in your browser, made callable by an agent. The browser versions run entirely on your own machine; this server exists for the case where the caller is not a person.

- Endpoint: `https://goaichat.app/mcp-tools/mcp`
- Transport: streamable HTTP (`"type": "http"`)
- Auth: **none** — no key, no account
- Server name reported to clients: `goai-tools`
- Tools: **31**

**Not the same as [/mcp](https://goaichat.app/mcp).** That is a different product: an on-device server inside the GO AI Chat Mac app, reachable only from localhost, requiring a pairing token, whose tools call real generative models metered against your Lab-token balance. See the comparison below.

---

## Connect

There is no pairing step. Add the endpoint and your client discovers all 31 tools on its next handshake.

### Claude Code

```
claude mcp add --transport http goai-tools https://goaichat.app/mcp-tools/mcp
```

### Cursor / Claude Desktop / JSON-config clients

Add to `mcp.json` (Cursor) or `claude_desktop_config.json` (Claude Desktop):

```json
{
  "mcpServers": {
    "goai-tools": {
      "type": "http",
      "url": "https://goaichat.app/mcp-tools/mcp"
    }
  }
}
```

Also published in the official MCP registry as `app.goaichat/tools`, and on
Smithery at https://smithery.ai/servers/feghaldev/goai if your client installs
from there.

---

## Tools (31)

### Images & media (6)

Decode, resize, re-encode and strip. Runs server-side with libvips and ffmpeg.

| Tool | Description |
|---|---|
| `strip_image_metadata` | Remove EXIF, GPS, XMP and IPTC data from an image, including PNG text chunks |
| `convert_heic_to_jpg_png` | Convert iPhone HEIC/HEIF photos to JPG or PNG, singly or as a ZIP |
| `image_compress` | Re-encode to JPEG, WebP or AVIF at a chosen quality, with before/after byte counts |
| `image_compression_curve` | Sample 14 quality levels and return the size-versus-quality curve, no image bytes |
| `resize_images` | Batch resize against real presets — App Store, Android mipmap, social cards |
| `convert_video_to_gif` | Trim a short clip into a GIF, MP4 or WebM with a median-cut palette and dithering |

### iOS & App Store (10)

The asset generation and submission checks an app release actually needs.

| Tool | Description |
|---|---|
| `generate_app_icon_set` | One image into a full iOS AppIcon.appiconset plus Android mipmap densities |
| `generate_favicon_set` | Favicon ICO, PNG sizes, Apple touch icon and a web app manifest |
| `render_app_store_screenshot` | Composite device-framed App Store screenshots with text layers |
| `build_app_store_link` | Build a storefront URL with campaign attribution, optionally with a QR code |
| `calculate_app_store_net_revenue` | Strip storefront VAT, apply Apple's commission, show what you receive |
| `appstore_search` | Search one App Store country storefront via Apple's public Search API |
| `appstore_compare_markets` | Look one app up across as many as 30 storefronts in a single call |
| `inspect_mobileprovision` | Read a provisioning profile: team, entitlements, devices, expiry |
| `check_strings_files` | Diff iOS .strings files for missing, extra and duplicate keys |
| `goai_build_app_privacy_label` | Turn what your app collects into an App Store privacy label checklist |

### Colour & layout (5)

Colour maths that is tedious by hand and easy to get subtly wrong.

| Tool | Description |
|---|---|
| `check_contrast` | WCAG 2 ratio and APCA lightness contrast for a foreground/background pair |
| `find_nearest_passing_color` | Nudge a colour to the nearest WCAG-passing shade, keeping its hue |
| `oklch_convert` | Convert between OKLCH, hex, RGB and HSL, with gamut clamping |
| `oklch_ramp` | Generate a perceptually even swatch ramp as CSS custom properties |
| `css_clamp_calculator` | Build a `clamp()` declaration interpolating between two viewport widths |

### AI helpers (2)

Deterministic estimates *about* models. No model is called.

| Tool | Description |
|---|---|
| `estimate_ai_tokens` | Heuristic token count, context fit and cost estimate for a piece of text |
| `recommend_ai_model` | Suggest a model for a task from a scored rubric, with the reasoning shown |

### Everyday calculators (8)

| Tool | Description |
|---|---|
| `calculate_bmi_and_body_fat` | BMI plus US Navy circumference body fat and lean mass |
| `calculate_tdee` | Total daily energy expenditure and a macro split |
| `project_weight_goal_date` | Project the date a weight goal is reached at a given deficit |
| `recipe_convert_ingredient` | Cups to grams using per-ingredient density, not a single conversion |
| `recipe_scale` | Scale a recipe's servings and return gram weights |
| `plant_watering_calendar` | Build a watering schedule and return it as a downloadable `.ics` |
| `estimate_window_light` | Estimate light levels at a window from aspect, glazing and obstructions |
| `bpm_delay_calculator` | Resolve a tempo and return the full delay and LFO table in ms and Hz |

---

## Limits

Stated plainly rather than discovered at runtime. This is one small server doing real work for free.

- **No AI, ever.** Every tool is deterministic computation. Nothing here calls a model, which is exactly why it can be free.
- **4 MB per input file**, and per call in aggregate. Inputs are base64 inside the JSON request; larger files are refused by validation with a message naming the limit.
- **One heavy call at a time.** Screenshot rendering and video conversion are memory-hungry; a second concurrent heavy call is refused in milliseconds rather than queued, so you get a clear answer instead of a timeout.
- **Short clips only.** `convert_video_to_gif` is bounded so a call finishes inside the proxy's limit. It turns a few seconds of screen recording into a GIF; it is not a transcoder.
- **1200 requests per minute** per caller, with connection and arrival-rate ceilings at the proxy as well.
- **Results expire.** Anything too large to return inline comes back as a one-shot link under `/mcp-tools/files/<token>`, deleted on first download or after an hour, whichever comes first.

---

## This server vs. the GO AI Chat MCP server

| | This server (`/mcp-tools`) | GO AI Chat (`/mcp`) |
|---|---|---|
| Where it runs | Hosted by us, public internet | On your Mac, inside the app |
| Reachable from | Anywhere | localhost only |
| Auth | None | Bearer pairing token |
| What the tools do | Deterministic computation | Image, video and media generation |
| Cost | Free | Metered against Lab tokens |
| Requires | Any MCP client | GO AI Chat for Mac, kept running |

---

## FAQ

**Is it really free?**
Yes. No API key, no account, no signup. Every tool is deterministic computation — no model is called, so there is nothing to bill. Please be reasonable with it; it runs on one small server.

**Is anything stored?**
No. Nothing is written to a database and tool inputs are not logged. Files you send are held in memory for the duration of the call. Results too large to return inline are written to disk behind a one-shot random link, deleted the first time it is fetched or after an hour.

**Why is there no API key?**
Because the tools cost nothing to run and hold nothing worth protecting. Auth exists in the server and can be switched on with a single environment variable if that changes.

**What happens to files I send?**
They are decoded in memory, processed, and discarded when the call returns. Only generated output that is too large to inline touches disk, under a random token, on a timer.

**How does this differ from the Mac app's server?**
See the comparison table above. Different hosting, different reachability, different auth, and different tools — that one generates media with real models and is metered.

---

## Links

- This page: https://goaichat.app/mcp-tools
- Browser versions of the same tools: https://goaichat.app/tools
- GO AI Chat's on-device MCP server: https://goaichat.app/mcp
- Support: support@goaichats.com
- Back to GO AI homepage: https://goaichat.app/
