Early access — manual onboarding

SteelSpec MCP Server: UK Steel Data for AI Agents

Register the SteelSpec Model Context Protocol server with Claude Desktop, the Anthropic Agent SDK, or any MCP-compatible AI client. Sixteen tools covering UK structural sections, cold-formed purlins, connection design rules, embodied carbon, material grades, plate, fixings and weld design — all queryable directly by your agent without intermediate API plumbing.

Status: the server runs locally via stdio transport. While we wait to see whether there's enough interest to justify a public release, the server file and data are sent on request — email us and we'll get you set up.

How to get set up

  1. Email hello@structuralsteelcomponents.com with the subject "SteelSpec MCP access". Tell us what you're building. We'll send you the Python server file and the JSON data directory.
  2. Install the MCP SDK: pip install mcp
  3. Add this snippet to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, equivalent path on Windows / Linux):
{
  "mcpServers": {
    "steelspec": {
      "command": "python",
      "args": ["/path/to/steelspec-mcp-server.py"],
      "env": {
        "STEELSPEC_DATA_DIR": "/path/to/steelspec/data"
      }
    }
  }
}

Restart Claude Desktop. The 16 SteelSpec tools become available in any new conversation.

16 tools, organised by purpose

Section lookup

ToolWhat it does
list_section_typesLists all UK section types in the registry, grouped by category
lookup_sectionFull properties of a specific section (e.g. UB 305×165×40)
list_section_designationsEvery designation for a type, sorted by mass
find_sections_by_massFind sections within a mass tolerance (for substitution / sizing)
get_purlin_sectionsZ or C purlins, filterable by manufacturer and depth
get_eaves_beam_sectionsCold-formed eaves beam reference data

Connection design (BS EN 1993-1-8)

ToolWhat it does
get_bolt_capacityTensile and shear resistance per bolt for any size + grade
get_bolt_spacing_rulesMinimum end / edge / pitch / spacing per Eurocode 3 Table 3.3
get_weld_design_dataMin throat by plate thickness, common weld sizes, weld categories

Material and components

ToolWhat it does
get_material_gradeYield, tensile, charpy values for any UK grade (S275, S355, etc.)
list_material_gradesList of all grades with quick-summary properties
get_plate_dataStandard plate thicknesses, weights, sheet sizes, grade availability
calculate_plate_weightWeight + embodied carbon for a plate by dimensions
get_fixingsBolts, anchors, fasteners reference data (filterable by category)

Sustainability and registry

ToolWhat it does
estimate_embodied_carbonkgCO₂e for any mass + production route + life-cycle modules
get_data_registry_summaryOverview of what's in the registry (counts, freshness, sources)

What an agent can do once registered

User prompt: "I'm specifying a 6m simply supported beam carrying 30 kN/m UDL. Find me the lightest UB that works, and show me the embodied carbon if I source it from BCSA UK average vs Histar low-carbon."
Agent calls:
  • find_sections_by_mass("UB", 30, 50) — get candidate UBs
  • lookup_section("UB", "305x165x40") — verify section properties
  • estimate_embodied_carbon(50000 × 6, "uk-average", ["A1-A3"])
  • estimate_embodied_carbon(50000 × 6, "eaf-scrap-100pct", ["A1-A3"])

Returns a worked recommendation with section choice, weight, and 60-70% lower carbon if Histar is specified.

User prompt: "Check my fin plate connection: 10 mm S275 plate, M20 grade 8.8 bolts at e₁=e₂=40mm, p₁=70mm. Will it fail in bearing or bolt shear first?"
Agent calls:
  • get_bolt_spacing_rules("M20") — confirm geometry passes minimums
  • get_bolt_capacity("M20", "8.8") — get Fv,Rd
  • Calculates Fb,Rd from formula using k₁ = 2.5, αb = 0.61 / 0.81

Returns: Fv,Rd = 94.1 kN, Fb,Rd = 114.7 kN end / 152.3 kN inner. Bolt shear governs. Plate could be reduced.

User prompt: "What Z purlins does Steadmans make at 200 mm depth?"
Agent calls:
  • get_purlin_sections("Z", manufacturer="Steadmans", depth_mm=200)

Returns 6 Steadmans 200-deep Z sections (SZ200/14 through SZ200/25) with full geometric and mechanical properties verified against the 2025 design guide.

Installation options

Option 1: Local stdio (available now, on request)

Run the server locally on your machine. Suitable for individual developers, agent prototyping, and offline workflows.

# 1. Install the MCP SDK
pip install mcp

# 2. Email hello@structuralsteelcomponents.com to get
#    steelspec-mcp-server.py and the data/ directory.
#    (No public package yet — manual onboarding while
#    we gauge interest.)

# 3. Run it
python /path/to/steelspec-mcp-server.py

Then add the config snippet from the Quickstart at the top of this page to your Claude Desktop config.

Option 2: Remote SSE (roadmap)

Hosted SSE transport for production agents and team usage. Single endpoint, authenticated by API key. Will deploy when there's enough demand to justify the hosting — email us if this is something you'd want.

{
  "mcpServers": {
    "steelspec": {
      "url": "https://mcp.steelspec.io/sse",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Anthropic Agent SDK

Same registration pattern via the Agent SDK's MCP server registration. Once you have the local server file (Option 1), it works the same way as Claude Desktop — point the SDK at the script.

Tool roadmap

Tools planned alongside the next substrate layers.

ToolStatusDescription
parse_ifc_to_bomComingUpload an IFC file, get a categorised BOM with embodied carbon
size_minimum_plateComingComponent design agent: minimum-material plate dimensions for given loads
generate_dxfComingParametric DXF for any UK section profile
request_quoteComingProcurement agent: indicative quote for components from supplier network

Building an AI tool that needs UK steel data?

Email us, tell us what you're working on, and we'll send the server file and data so you can register it with your client. Free for local use during the manual-onboarding phase. If enough people ask for a hosted SSE endpoint, that's the trigger to deploy one.

Contact: hello@structuralsteelcomponents.com with the subject "SteelSpec MCP access".

REST API documentation →

Powered by SteelSpec
Shopping Basket