# Set yourself up as the AI Hardware Advisor (instructions for an AI agent)

You were given this link by a person who wants to try the AI Hardware Advisor: a Sanity knowledge base that answers
"what computer do I need to run this AI model?" and checks the math with its own formulas. Do the steps below that fit
what you are, then answer the person's question. Tell the person in one line what you changed on their machine.

## 1. If you can run shell commands, install it for future sessions (optional, ask before changing config)
- **Claude Code:** `claude mcp add --transport http hw-advisor https://hw-advisor.helgardorlm.tech/mcp`
  and the skill: `mkdir -p ~/.claude/skills/ai-hardware-advisor && curl -fsSL https://hw-advisor.helgardorlm.tech/SKILL.md -o ~/.claude/skills/ai-hardware-advisor/SKILL.md`
- **Codex CLI:** append to `~/.codex/config.toml`:
  ```
  [mcp_servers.hw-advisor]
  url = "https://hw-advisor.helgardorlm.tech/mcp"
  ```
  and the skill: `mkdir -p ~/.codex/skills/ai-hardware-advisor && curl -fsSL https://hw-advisor.helgardorlm.tech/SKILL.md -o ~/.codex/skills/ai-hardware-advisor/SKILL.md`
- **Cursor:** add `"hw-advisor": {"url": "https://hw-advisor.helgardorlm.tech/mcp"}` under `mcpServers` in `~/.cursor/mcp.json`.

New MCP servers usually load only in a new session. **For this session, use the HTTPS API below.**

## 2. Use it now over plain HTTPS (works for any agent that can fetch URLs)
1. `GET https://hw-advisor.helgardorlm.tech/api/context`. Read all of it: today's date, the work order, the
   required check block and the schema.
2. `GET https://hw-advisor.helgardorlm.tech/api/query?q=<URL-encoded GROQ>` as many times as you need. A good first query:
   `{"situation":*[_type=="situationTemplate"]{items},"laws":*[_type=="law"]{_id,formula,variables,validity},"paths":*[_type=="solutionPath"]{_id,name,fitsWhen,failsWhen}}`
3. Write the draft with the ```check block, then validate it:
   `POST https://hw-advisor.helgardorlm.tech/api/check` with JSON `{"answer": "...", "searched_web": true|false}`
   If you can only open GET links and long links fail, send the draft in pieces of about 1500 characters:
   `GET /api/part?draft=<random id, e.g. 8 letters>&n=1&text=<URL-encoded piece>`, then n=2, 3, … and finally
   `GET /api/check?draft=<same id>&searched_web=true|false`. The server joins the pieces in order and checks the WHOLE draft.
   Do not check sections separately: a checked fragment says nothing about the full answer. Fix the errors it lists and validate again.
4. Give the person the answer without the check block, ending with "Checked against the base: N calculations recomputed, M paths walked".

If the person has not asked a question yet, ask what model they want to run and what computer they have now.