Skip to main content
Glama
Ottoref
by ottonic

Ottoref — Standards MCP Server

Reference standards for mechanical engineering, as data an assistant can query: ISO 286 limits and fits, ISO 2768 general tolerances, indicative material properties, and published process feasibility limits. Nothing here comes from a CAD file — it is the reference layer that turns a measurement, or a measurement-plus-drawing question, into an answer you can cite.

Every value is taken from the published tables, carries the edition it came from, and is checked against independent fixtures. Anything the server cannot verify, it refuses with a reason rather than approximating — so a number from this server is one you can put your name to.

Tools

Tool

Returns

list_standards

Which standards are implemented, and what within each is covered.

limits_of_size

Upper and lower deviations and limits for one ISO 286 class at one nominal size, e.g. 36H7.

iso286_applicability

Exact size intervals where one ISO 286 tolerance class is supported, e.g. H7, j5 or N9.

fit

Fit type, clearance and interference for a hole and shaft pair at one nominal size, e.g. 12 H7/h6.

it_grade

The standard tolerance value for one IT grade at one size, in micrometres and millimetres (IT01, IT0, IT1–IT18).

general_tolerance

The ISO 2768-1 general tolerance for a class: linear, broken-edge, or angular.

general_tolerance_complies

Whether a stated deviation complies with a general-tolerance note.

material_properties

Typical SI properties for one material designation.

material_coverage

Which material grades and families are covered.

process_limits

Published geometric feasibility limits for a process.

process_feasibility

A check of a stated value against those process limits.

process_list

Which processes are covered.

Related MCP server: k12-lesson-toolkit-standards-server

What it covers

ISO 286-1:2010, with Cor 1:2013 applied provides standard tolerance grades IT01, IT0 and IT1 to IT18 for nominal sizes up to 500 mm. Shaft limits cover c–h, k, m, n, p, r–v, x–z, and za–zc where Table 4/5 publishes a cell, using its exact size intervals and grade rules. Verified hole classes C, D, E, F, G, H, JS, K, M, N, P, R, S, T, U, V, X, Y, Z, ZA, ZB, ZC use the Table 2/3 ∆ corrections and the M6 exception, and grade-specific shaft j5–j7 (and j8 up to 3 mm) and hole J6–J8 use their own table values. iso286_applicability reports the exact supported size intervals for a class; gaps are stated, never interpolated.

ISO 2768-1:1989 provides general tolerances for linear dimensions (classes f, m, c, v), broken edges (classes f and c), and angular dimensions (classes f, c, v), plus a compliance check for a stated deviation.

Materials are indicative typical values for common metals and plastics, from an Apache-2.0 reference, tagged basis: typical. Process limits are published rules of thumb for cnc-machining, sheet-metal, injection-molding, and additive-sls.

Out of scope, and refused rather than guessed: nominal sizes above 500 mm and the inch counterparts (ANSI B4.2); IT01–IT2 K/M/N/P–ZC combinations and sparse Table 2/3 cells with no published ∆ value; design allowables, fatigue, and high-temperature data; and a specific shop's capability, achievable tolerance, cost, or lead time.

How the values are produced

The values are the published tables, which are normative. The earlier editions also define the tolerance factor i = 0.45·∛D + 0.001·D and give the grades as multiples of it; that arithmetic reproduces the table at 18 mm and above but diverges at the smallest size step, where the published IT18 is 1400 µm against 2500i = 1355 µm. toleranceFactor() is kept as a documented cross-check, and the tests assert both the table and the divergence.

What it does not do

It reports what a standard specifies. It does not decide whether a design is acceptable, whether a fit suits a joint, or whether a part can be made — those are engineering judgements and they stay with you. Approval, compliance, and certification are out of scope.

Install and run

npm install
npm run build
node dist/src/index.js        # serves MCP over stdio

Point an MCP host at dist/src/index.js. The server serves both protocol eras: the 2025-11-25 handshake that stock MCP hosts negotiate, and the 2026-07-28 envelope through server/discover.

Development

just check          # fmt-check, lint, typecheck, test
just build
just test

just check is keyless and needs no data files: the values are in the source.

Packaging

npm pack builds first and includes the compiled server and this README; tests and source maps are excluded. Install the tarball to check the standards-mcp executable with a compatible MCP client.

License

MIT. Third-party notices: THIRD_PARTY_NOTICES.md.

Available Tools

12 tools
fitFit Between a Hole and a ShaftA

Return the resulting fit between one hole class and one shaft class at the same nominal size, such as 12 H7/h6: the type (clearance, transition or interference), the minimum and maximum clearance, and the maximum interference. Values are millimetres. A negative minimum clearance means the fit can interfere. This reports the geometry of the fit, not whether it is the right choice for a joint, which depends on function and is the caller's decision.

Inputs: hole (required), shaft (required), nominal (required). Returns: object

general_toleranceISO 2768-1 General ToleranceA

Return the deviation that a general-tolerance note such as ISO 2768-m implies for one dimension, so an unmarked dimension can be checked. The tables differ by what they cover: linear dimensions, broken edges (external radii and chamfer heights), and angular dimensions, which are keyed by the shorter side of the angle rather than the nominal size. A general tolerance applies only where the drawing gives no individual tolerance, so check for one first.

Inputs: nominal (required), tolerance_class (required), kind. Returns: object

general_tolerance_compliesCheck a Deviation Against an ISO 2768-1 NoteA

Compare a stated deviation numerically against the ISO 2768-1 general-tolerance value for one dimension. This is only a numeric comparison: first establish that the dimension has no individual tolerance indication, because the general tolerance applies only to unmarked dimensions. The result does not establish process capability.

Inputs: nominal (required), tolerance_class (required), stated_deviation (required), kind. Returns: object

iso286_applicabilityCheck ISO 286 Class ApplicabilityA

List the exact nominal-size intervals where one ISO 286 tolerance class is supported, such as H7, j5 or N9. Use this before relying on a class across a size range; omitted intervals are not inferred.

Inputs: designation (required). Returns: object

it_gradeStandard Tolerance Grade ValueA

Return the standard tolerance value for one IT grade at one nominal size, in micrometres and millimetres, with the size step it came from. Use this when a drawing or a calculation needs the tolerance width itself, rather than the limits of a specific class.

Inputs: grade (required), nominal (required). Returns: object

limits_of_sizeLimits of Size for a Tolerance ClassA

Return the upper and lower deviations, and the resulting limits, for one tolerance class at one nominal size, such as 36H7 or 36g6. Uppercase is a hole, lowercase a shaft. Values are millimetres and are deviations from the nominal size. Use this to interpret a toleranced dimension; whether the resulting limits suit a joint is an engineering decision.

Inputs: nominal (required), designation (required). Returns: object

list_standardsList Standards CoverageA

List the standards this server implements, and what within each one is not covered. Call this first when a question mentions a standard, so you know whether the value you need is available before you promise an answer. Coverage is partial by design: unimplemented values are refused with a stated reason rather than approximated. Use iso286_applicability for exact size intervals of an ISO 286 class.

Inputs: no named parameters. Returns: object

material_coverageWhat Material Data Is HeldA

List what the material reference holds and what it does not. Call this when a material was not found, or before promising a property, so a gap is visible rather than assumed. The reference is limited to typical values for common metals and plastics: it holds no design allowables, no fatigue data and no high-temperature data.

Inputs: no named parameters. Returns: object

material_propertiesMaterial Properties (Typical Values)A

Look up indicative material properties for a common metal or plastic by designation, such as 6061-T6, 304 or Ti-6Al-4V. Returns density, yield and ultimate strength, Young's modulus, Poisson's ratio, elongation, thermal expansion and maximum service temperature, all in SI. These are TYPICAL handbook values, not design allowables: every value is tagged basis: typical. Use them to compare materials, estimate mass, or supply an indicative modulus to an analysis; obtain an allowable from a qualified source before relying on a strength margin. An unmatched designation means this reference does not hold it, not that the material does not exist.

Inputs: material (required), property. Returns: object

process_feasibilityCheck a Feature Against Process LimitsA

Compare one measured feature against a manufacturing process's limits and report whether it is within, marginal, or beyond them. Some limits are expressed as a ratio of material thickness rather than an absolute size — a 1 mm hole is fine in thin sheet and difficult in thick plate — so supply the thickness when the limit needs it. A result inside the limits is not a promise that a shop can make the part, or an estimate of what it costs. Pair this with a measured wall or hole size from a CAD server to answer whether a part suits a process.

Inputs: feature (required), process (required), measured (required), thickness. Returns: object

process_limitsManufacturing Process LimitsA

Describe what a manufacturing process can hold: minimum wall thickness, minimum hole-to-edge and hole-to-bend distances, minimum internal corner radius, bend radius, draft angle, pocket depth-to-width ratio. Call process_feasibility to test one measured feature against these. These are published rules of thumb for geometric feasibility, not a specific shop's capability, and they say nothing about cost or lead time.

Inputs: process (required). Returns: object

process_listList Manufacturing ProcessesA

List the manufacturing processes this server has limits for, and which features each one covers. Call this first when a question names a process, so an unsupported process is visible before a check fails.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct resource/action: IT-grade width vs class limits vs fit, coverage lists vs value lookups, and limit description vs feasibility checking. The paired tools (general_tolerance/general_tolerance_complies, process_limits/process_feasibility) are explicitly distinguished by their descriptions.

    Naming Consistency3/5

    All names use snake_case, but the pattern is mixed: list_standards is verb_noun, limits_of_size and general_tolerance are noun phrases, fit is a bare noun, and process_list/general_tolerance_complies invert the order. Readable but not a predictable convention.

    Tool Count5/5

    12 tools is well within the typical 3-15 range and matches the server's multi-domain reference purpose. Each tool covers a specific lookup, coverage check, or feasibility operation without obvious redundancy.

    Completeness4/5

    Coverage is strong across ISO 286 limits/applicability, IT grades, fits, ISO 2768 general tolerances, materials, and process limits/feasibility, with coverage tools to expose gaps. Minor gaps remain, such as no broader GD&T/surface-finish coverage or full standard-value lookup, but agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives an AI assistant a set of real mechanical-engineering tools. Provides deterministic tools like material properties, beam analysis, unit conversion, and curve fitting for engineering calculations.
      5
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Local-first, read-only MCP server for retrieving and searching authorised CCSDS and ECSS standards, enabling citation-rich passage-level search and document access.
      3
      -
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server providing steel domain knowledge to AI agents — grade properties, substitution verdicts, and mill-cert guidance as MCP tools. 23 grades, trade-verified substitution logic. Returns honest "not in knowledge base" rather than guessing.
      3
      MIT