Skip to main content
Welcome to the NCSEA Hackathon on 27 October. You are one of the first people outside our team to use these tools. Use Connections Hub from your own AI assistant or code: run real HSS connection calculations, get the verdict and a link to the live calculation. Full documentation: Connections Hub API docs.
Three steps: 1. Create your account. 2. Run the setup script. 3. Get going on your project.Please do steps 1 and 2 before the day, so you find out early if anything needs fixing. A mentor will be on the floor to help (we’ll be in the red shirts).

Step 1. Create your account

  1. Find the invite email for NCSEA Hackathon on Connections Hub. Accept it and log in once. The links your calculations return only open after you’ve joined (check spam if you can’t find it).
  2. That email also contains your API key - which you will need in step 2.
No emails, already have an account with this email, or lost your key? Ask a mentor.

Step 2. Run the setup script

The installer finds the AI apps on your laptop, saves your key and connects each app to Connections Hub. It backs up each app’s settings file before changing it. Download: connections-hub-installer.zip
Check before you run it
  • Using Claude Desktop? Install Node.js LTS (version 22 or newer) from nodejs.org first. On a work laptop this may need IT.
  • Antivirus or a work laptop? Add api.calcs.com to its allowed or excluded websites (or ask IT). Otherwise Claude Desktop can stay on “Starting” forever.
  1. In Downloads, right-click connections-hub-installer.zip, choose Extract All, then Extract. Don’t run anything from inside the zip.
  2. Copy your API key from the email.
  3. Double-click install-connections-hub with the gear icon (Type: Windows Command Script), not the other files with the same name. The install-connections-hub Windows Command Script in the extracted folder
  4. If Windows says “The publisher could not be verified”, click Run. If it says “Windows protected your PC”, click More info, then Run anyway. Windows security warning for the installer
  5. Paste your key (right-click pastes; you’ll see * as it goes in) and press Enter. If Claude Desktop is open, the installer asks to close it: press Enter. It reopens Claude when it’s done. The Windows installer after it finishes
Did it work? At the end the window lists Configured: and your apps. If your app is there, you’re set. The first time you use it, your app asks permission to use the tools: click Allow. Works with Claude Desktop, VS Code (GitHub Copilot, Agent mode), Cursor, Antigravity, Claude Code and Codex CLI. It won’t work with ChatGPT or Claude in a web browser, phone apps, or Microsoft Copilot in Windows, Edge, Teams or Office. Prefer one of those? Use the API route in step 3.
  • Claude Desktop: the installer reopens it. In Settings → Developer, connectionshub should say Running.
  • VS Code: open Copilot Chat, choose Agent, click the tools icon, tick connectionshub, and paste your key when VS Code asks.
  • Cursor: Cursor Settings → MCP (Tools & MCP in newer versions) → switch connectionshub on.
  • Antigravity: open MCP Servers and click Refresh.
  • Your app isn’t listed: open it once, close it, rerun the installer.
  • Needs attention next to an app you use: set it up by hand (below). Next to one you don’t use: ignore it.
PowerShell line (open PowerShell in the extracted folder and replace YOUR_API_KEY with your key):
Windows and Mac
Claude Desktop (needs Node.js 22 or newer): Settings → Developer → Edit Config. A folder opens: right-click claude_desktop_config.json, choose Open with, then Notepad (Mac: TextEdit). If it’s empty or only {}, replace everything with the block below. Otherwise paste the file and this block into Claude and ask “Merge these into one valid JSON file.” Keep Bearer and its space, and write Authorization:${HUB_AUTH} exactly. Save, quit Claude Desktop completely (Windows: right-click the Claude icon by the clock, then Quit; Mac: Cmd+Q) and reopen it.
VS Code (GitHub Copilot): Command Palette (Ctrl+Shift+P / Cmd+Shift+P), then MCP: Open User Configuration, paste this and save. Then in Copilot Chat choose Agent, open the tools menu, tick connectionshub and paste your key when asked.
Cursor: Settings → MCP → Add new MCP server. Paste this with your key in place of paste-your-key-here, save, then switch connectionshub on (new servers start disabled). Put the key in the file itself: Cursor opened from the Dock or Start menu can’t see a key stored in your terminal.
Antigravity and Windsurf (Devin Desktop): open the raw MCP config from the app’s MCP servers panel (“View raw config”), paste this with your key, save, then click Refresh. Windsurf is not tested by us and needs a paid Devin plan. Use its Local mode.
Claude Code (store your key first: see “Scripts and code” below). Windows PowerShell:
Mac Terminal:
Then run claude and type /mcp: you should see connectionshub: connected. Ran the add line before storing the key or opening a new window? Claude Code saved an empty key: run claude mcp remove connectionshub, then add it again.Codex CLI (store your key first):
Sign in with your ChatGPT account, then type /mcp: connectionshub: connected.More detail on each app, the 13 tools, and timeouts: MCP server.

Step 3. Get going on your project

Paste this into your AI:
This takes about a minute. You should get back:
  • Verdict: pass, fail, error or not_evaluated.
  • Governing check and its utilization (1.0 or less passes).
  • Links to the calculation and the project. Open them in Connections Hub.
Next, try: “Change the dead and live shear loads to 10 kip each, solve again, and compare.” It should now fail. Ask your AI what to change to make it pass. Want a report? Ask it to export the project as a PDF. To see everything you can run: “Use the connectionshub tools. List all the calculators I can use.” Working in a team? One laptop driving the agent works best. Everyone in your team can open the links once they’ve accepted their own invite. Put your team name in project names so you can find your work.
  • HSS connection optimization: set your own loads, then try five column sizes and pick the lightest that passes.
  • HSS truss designer
  • HSS education tool
  • From a spreadsheet: read connections from a CSV, run each one, write a summary table with verdicts and links.
  • Calc pack: run a set of connections and export the project as one PDF.
  • Explain it: ask your AI why a check governs and what to change.
Think about what you find most frustrating in your workflow to do with connections, and build something to solve it!
  • Units: send values with their unit, like "24 ft" or "100 kip". The API converts them and tells you straight away if a unit doesn’t fit that input.
  • Start from a preset and change one or two inputs at a time. If you get error, go back to the preset and change one thing.
  • Timing: about 15 s per calculation, 30 to 40 s for truss connections. 20 options one after another is about 5 minutes; plan bigger loops around that.
  • Deleting is switched off for hackathon keys. Ask a mentor if you need something removed.
  • Errors: 422 means an input wasn’t accepted (the message names the input and what to send, often a unit or an option). Verdict error means the calculator couldn’t evaluate that design: go back to the preset and change one input at a time. 403 “Deletes are disabled” is expected. 500 or a timeout: try once more, then show a mentor the error.
Your AI writes a script (Python is easiest) that calls the API with your key. Full reference: API docs. Good for loops, spreadsheets and batch runs. You need Python installed and somewhere to run the script: a terminal, or an AI app that runs code for you (VS Code, Cursor, Antigravity, Claude Code).
Your key is already set. The installer saved it as HUB_API_KEY on your computer, and that is all the API needs. Open a new terminal window (windows that were open during the install can’t see it) and the examples below just work. You never paste the key into a script.
Windows (PowerShell: press the Windows key, type PowerShell, press Enter; no admin needed):
Mac (Terminal):
Now close this window and open a new one. Your key only works in windows opened after you store it (Mac: or run source ~/.zshrc).
Test it. Windows (PowerShell): type curl.exe, not curl:
Mac:
You should see two calculators and "total".Your first script. Give your AI this:
Then change the Task line to what you want to build.
A web page can’t call api.calcs.com directly, so put a small server between your page and the API. Your AI can build it: do this in VS Code, Cursor, Antigravity or Claude Code (they create and start it for you). Your key is already saved as HUB_API_KEY by the installer (no installer? see “Scripts and code” above), so just paste this and describe your app on the last line.
  • Putting it online (Vercel, Netlify, Lovable)? Make the API calls from a serverless function and put the key in the host’s environment settings, never in the page.
  • Claude artifacts and other in-chat previews can’t call the API live. They can show results your AI has already fetched.

Help and feedback

Find a mentor on the floor: we’ll be in the red shirts. We’d love to hear what worked and what didn’t. Documentation: Connections Hub API docs