Steel Brain

io.github.dryow1Published by GitHub account dryow1v1.1.0Updated Nov 2, 2026

Trade-verified steel grade properties, substitution verdicts, and mill-cert guidance for AI agents.

The publisher's own server: BrainDog

VerifiedStreamable HTTPWeb executable

Overview

AI-generated overview

Steel Brain gives an assistant trade-verified steel grade data: properties, substitution verdicts and mill-cert guidance, over remote HTTP or local stdio.

What you can do
  • Look up a steel grade's properties, chemistry, forms, applications and weldability, with aliases resolved
  • Check whether one grade can substitute another for machined, welded-structural or pressure applications, with a verdict and reasoning
  • Find which mill certificate type applies for a grade and use case and which fields to check
  • Return an explicit "not in knowledge base" for unknown grades instead of guessing
When to use it
Useful when an assistant is asked about steel grades, material substitution or mill certificates and a confident guess would be risky, for example comparing 4140 annealed with pre-hardened or 316L with 304L for marine use. Coverage is limited to 23 grades and 39 substitution rules.
Requirements
Remote option: point any MCP client supporting streamable HTTP at the published endpoint; no API key needed. Local option: Python with the project's requirements installed, run as a stdio module. The separate REST API uses an X-API-Key header.
Before you install
The remote endpoint has a shared daily cap, so availability is not guaranteed. Answers come from a limited knowledge base (23 grades, 39 rules, 4 cert guides) and are guidance, not a substitute for engineering sign-off. The REST API requires an API key; the MCP tools do not.

Installation

In SourceWeft

  1. Open Steel Brain in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dryow1%2Fsteel-brain/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "steel-brain": {
      "type": "http",
      "url": "https://api.steelbrain.dev/mcp"
    }
  }
}

README

Steel Brain

An MCP server providing steel domain knowledge to AI agents — grade properties, substitution verdicts, and mill-cert guidance, delivered as MCP tools your agent can call.

Also available as a REST API at https://api.steelbrain.dev.


MCP server

Steel Brain is a Model Context Protocol server. It exposes three MCP tools, over remote streamable HTTP (no install) or local stdio:

MCP ToolWhat it does
grade_lookupProperties, chemistry, forms, applications, weldability for a steel grade. Aliases resolved (4140 = 42CrMo4 = SCM440; S355 = ST52).
substitution_checkGiven from_grade, to_grade, application, returns a verdict (valid / conditional / invalid) with reasoning on whether one grade can substitute another.
cert_guideWhich mill certificate applies for a grade + use case (EN 10204 3.1/3.2, class certs ABS/DNV/LR/BV/NK) and what to check.

Remote (no install, free)

Point any MCP client that supports streamable HTTP at:

https://api.steelbrain.dev/mcp
{  "mcpServers": {    "steel-brain": { "type": "http", "url": "https://api.steelbrain.dev/mcp" }  }}

Claude Code: claude mcp add --transport http steel-brain https://api.steelbrain.dev/mcp

No API key needed. There is a shared daily cap to keep the server healthy.

Local (stdio)

pip install -r requirements.txtpython -m steel_brain.mcp_server

Starts the MCP server on stdio transport, ready for any MCP client (Claude Desktop, Claude Code, or any MCP-compatible agent).

Example MCP client config

{  "mcpServers": {    "steel-brain": {      "command": "python",      "args": ["-m", "steel_brain.mcp_server"]    }  }}

Built with the official MCP SDK (mcp package), registering three tools via the standard MCP tool interface.


Why Steel Brain

LLMs guess at steel. They will tell you 4140 annealed can stand in for 4140 pre-hardened, and scrap the job. Steel Brain answers from a human-verified knowledge base built by a working steel trader, and returns an honest "not in knowledge base" rather than a confident guess.

The valuable part is the substitution and cert logic:

  • 4140RB to 4140QT (annealed vs pre-hardened): invalid, same alloy, opposite heat-treat
  • 316L to 304L for marine: invalid, different corrosion class
  • EH36 to S355 structural: valid one way, conditional the other
  • Seamless vs ERW for pressure service: never interchangeable

Coverage

23 grades across carbon, alloy, stainless. Round bar, hollow bar, plate, pipe. 39 substitution rules, 4 cert guides.

REST API (alternative to MCP)

Same knowledge over REST at https://api.steelbrain.dev :

curl "https://api.steelbrain.dev/v1/grade/4140QT" -H "X-API-Key: YOUR_KEY"curl "https://api.steelbrain.dev/v1/substitution?from_grade=316L&to_grade=304L&application=machined" -H "X-API-Key: YOUR_KEY"

Free tier at launch. Contact: [email protected]

Honesty by design

  • Grade properties: published-standard ranges (ASTM/EN/JIS/API/ABS), labelled as such.
  • Substitution + cert logic: trade-verified, dated rulings from a working trader.
  • Unknown grades: honest "not in knowledge base," never fabricated.

Development

One-command local test setup:

make test

or directly:

bash scripts/test.sh

This creates a .venv (via python3 -m venv .venv) if it doesn't exist yet, installs requirements.txt into it, sets SB_SERVE_UNVERIFIED=1 (needed so the test suite can exercise unverified KB entries), and runs pytest. Works on macOS and Linux. Extra arguments are passed through to pytest, e.g. bash scripts/test.sh tests/test_gate2.py -v.

python -m pytest tests/    # 15 tests (10 acceptance + 5 domain-safety guards)

License

Code: MIT (see LICENSE). Knowledge base (kb/): proprietary (see NOTICE).

Source: README.md at commit 27598ed

Tools

3

grade_lookup

Look up a steel grade: properties, chemistry, forms, applications, weldability. Aliases accepted (e.g. 4140 = 42CrMo4 = SCM440).

Parametersgraderequired

substitution_check

Check if one steel grade can substitute another for a given application (machined / welded-structural / pressure). Returns verdict + reasoning from verified trade rules.

Parametersto_graderequiredfrom_graderequiredapplicationrequired

cert_guide

Which mill cert type applies for a grade + use case (e.g. EH36 shipbuilding), and what fields to check on the cert.

Parametersgraderequireduse_caserequired

Version history

2
  1. v1.1.0LatestSep 25, 2026
  2. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Brain integrations