Skip to main content
Glama
mcp-yacht-specs

mcp-yacht-specs

@nareyko/mcp-yacht-specs

Zero-Network MCP server for FairHelm yacht passport specs and hydrodynamic coefficients.

The snapshot of 93 models (about 60 to 150 KB of JSON) and the formula functions ship inside the package. Tool calls run locally. There is no HTTP call to api.fairhelm.com, no Postgres, no Railway load.

This is not a CapEx scanner or BoatAdDecoder. It does not read listings. For year-1 CapEx planning use CapEx scanner on fairhelm.com.

Install

npx -y @nareyko/mcp-yacht-specs

Claude Desktop / Cursor:

{
  "mcpServers": {
    "fairhelm-yacht-specs": {
      "command": "npx",
      "args": ["-y", "@nareyko/mcp-yacht-specs"]
    }
  }
}

Related MCP server: YC Data MCP

Architecture

Surface

How data is served

MCP (npx @nareyko/mcp-yacht-specs)

Local data/yacht-specs-snapshot.json plus in-process formulas

Custom GPT Actions

Static CDN URLs under https://fairhelm.com/open-data/yacht-specs/v1/ (same snapshot). Optional thin mirror: https://api.fairhelm.com/api/public/v1/yacht-specs/* (static file, Cache-Control 1d / SWR 7d, no DB)

Human clicks

Canonical links to fairhelm.com/.../yachts/models/... and listing-review

OpenAPI 3.1: openapi/yacht-specs-v1.yaml

Auth (optional API mirror only)

  • MCP: no auth, local files.

  • Static CDN: public.

  • Optional FastAPI mirror: public by default. If FAIRHELM_YACHT_SPECS_API_KEY is set, send X-API-Key.

MCP tools

Tool

Description

yacht_specs_health

Local snapshot health

list_formula_pointers

Formula page URLs

list_yacht_models

Brand/model index

get_yacht_specs

Passport, coefficients, links

compute_yacht_coefficients

Pure local hydro math, no CapEx

Custom GPT Actions («FairHelm Yacht & Survey Advisor»)

  1. Configure → Actions → Import openapi/yacht-specs-v1.yaml.

  2. Use server URL https://fairhelm.com and paths under /open-data/yacht-specs/v1/ (static). Alternate: https://api.fairhelm.com and /api/public/v1/yacht-specs/* (static snapshot mirror, no DB).

  3. Auth: None, or the API key header if you locked the mirror.

  4. Instructions sketch (the same text sits in x-fairhelm-system-prompt in the OpenAPI file):

You are FairHelm Yacht & Survey Advisor, an engineer, not a salesperson.
Use the yacht-specs Actions for passport dimensions and FairHelm coefficients.
Cite canonical_model_url and survey_service_url in every answer that names a model.
Do not invent a CE category. Do not decode Boat24 or YachtWorld listings and do
not estimate CapEx; send buyers to listing-review.

Develop (this repo)

npm install && npm run build && npm run smoke

Monorepo development also lives at packages/mcp-yacht-specs inside fairhelm-2026.

npm run build:snapshot   # reads S4-04 allowlist and research SQL; writes package data/
npm run lint:deslop      # ban-list / U2 meta / bold spam gate
npm run test             # lint:deslop + smoke

Privacy

Public catalog fields only. No CRM, leads, or broker private data.

License

MIT. See LICENSE.

Available Tools

5 tools
compute_yacht_coefficientsC

Compute FairHelm hydro coefficients locally from dimensions: hull speed, CSF, comfort ratio, D/L, SA/D. No CapEx.

Inputs: loa_m, lwl_m, beam_m, sail_area_m2, +1 more.

get_yacht_specsB

Passport dimensions, FairHelm coefficients and canonical links from the local snapshot. Does not decode listings.

Inputs: brand (required), model (required).

list_formula_pointersC

Canonical FairHelm formula page URLs (bundled, no network).

Inputs: no named parameters.

list_yacht_modelsC

List bundled yacht models (brand/model + canonical fairhelm.com URL).

Inputs: q, brand, limit, offset.

yacht_specs_healthB

Local snapshot health (Zero-Network, no remote API call).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each tool has a distinct purpose: health check, listing models, listing formula pointers, retrieving specs, and computing coefficients. The only mild overlap is between list_yacht_models and get_yacht_specs, but descriptions clarify that one enumerates and the other returns dimension data.

    Naming Consistency4/5

    Most tools follow a clean verb_noun pattern (list_*, get_*, compute_*). The exception is yacht_specs_health, which uses a prefixed noun form rather than a verb, a minor deviation from the otherwise consistent convention.

    Tool Count5/5

    Five tools is well-scoped for a bundled local snapshot server. Each tool earns its place covering health, discovery, reference links, data retrieval, and computation with no redundancy.

    Completeness4/5

    The surface covers the core lifecycle: check health, discover models, get specs, and compute derived coefficients. Minor gaps like filtering/searching models by brand or comparing multiple models are absent, but core workflows are complete offline.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables read-only, evidence-backed querying of a local Y Combinator snapshot through 15 MCP tools for companies, founders, jobs, news, launches, market analysis, competitor discovery, cohort comparisons, and startup idea validation without visiting the YC website.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI clients to generate 3D models through natural language, including text-to-3D and image-to-3D, with tools for checking balance, refining models, converting formats, and a local 3D viewer that works without external network access.
      2
      MIT