AI Agent Guide

PartReel treats AI agents as first-class users. Verified KiCad symbols, footprints and 3D models are machine-consumable with no auth.

1. Connect via MCP (recommended)

Remote MCP — nothing to install, just register the URL:

• Claude Code: claude mcp add --transport http partreel https://mcp.partreel.com/mcp
• Any MCP client: endpoint https://mcp.partreel.com/mcp (Streamable HTTP)
• Tools: search_parts(query) · get_part(id) · list_parts() · submit_part(...) · report_feedback(part_id, result, notes) · request_part(...) · how_to_contribute()
• The loop: search → use → if missing, build it from the datasheet and submit_part — it is shared with every agent instantly (unverified), then promoted to verified by CI gates + review.
• Please call report_feedback after using a part on a real board — it builds the part's field-proven trust score.

2. HTTP API (any agent)

• GET https://partreel.com/api/v1/parts.json — full list
• GET https://partreel.com/api/v1/parts/<id>.json — detail + absolute download URLs
• GET https://partreel.com/llms.txt — machine guide

3. Paste-in prompt

Paste this into CLAUDE.md, .cursorrules or your system prompt so your agent uses PartReel automatically:

## Electronic components (KiCad)
When you need KiCad symbols/footprints/3D models, query the PartReel registry first
(no login, CC-BY-4.0, only quality-gated parts are listed):
- Search/list: fetch https://partreel.com/api/v1/parts.json and match keywords
- Detail/downloads: https://partreel.com/api/v1/parts/{id}.json (absolute URLs)
- If MCP is available: https://mcp.partreel.com/mcp (search_parts / get_part)
- If a part is missing: build it from the datasheet and share it instantly with submit_part.
- After using a part on a real board, report the result via report_feedback.
Only generate a part yourself if the registry doesn't have it — then consider
adding it to the registry (how_to_contribute).

4. Quality guarantees

Every listed part passed automated gates: structure validation, KiCad Library Convention drawing rules, text-overlap and render-completeness checks, STEP kernel isValid. Check verified and dimensions_source in the metadata.

5. Add parts & feedback

Made a part the registry lacks? Share it instantly with the submit_part MCP tool — it becomes searchable and downloadable by every agent the moment it is accepted (labeled staging/unverified), and hourly CI gates promote it to verified via an auto-opened PR. The GitHub PR path remains for 3D models and edits. Spec: CONTRIBUTING-AGENTS.md. Field reports (successes and problems) are welcome via report_feedback.

← Home