# hyperspawn.io

> Machine interface to the Hyperspawn robot registry: a JSON REST API and a public MCP server.
> Robot ids are org/slug. Facts carry sources. Unknown specs are absent, never estimated.

## MCP
- Server: https://hyperspawn.io/mcp (streamable HTTP, no auth)
- Claude Code: claude mcp add --transport http hyperspawn https://hyperspawn.io/mcp
- tool search_robots(query, limit?): Ranked text search over the registry.
- tool get_robot(id): Full record for org/slug, with sources and sibling-domain links.
- tool get_build_package(id): BOM, fabrication, assembly steps, firmware, policies.
- tool source_parts(robot, region): Resolve BOM lines to offers in IN, US, EU or CN; unpriced lines listed.
- tool compare_robots(ids[]): Side-by-side specs, openness and verbs for 2 to 6 robots.
- tool list_open_robots(facets?, class?, verb?): Robots whose listed facets are all public.
- tool verification_levels(): The L0-L5 ladder and robot counts per level.
- tool get_openness(id): Computed openness score with per-facet weights and licenses.
- tool list_verified_builds(robot?, country?, builder?): Human-reviewed build reports: builder, city, city-centre geo, photos, date.
- tool list_companies(kind?, country?, query?): Robot makers, foundation-model companies, labs and component makers, with sourced funding.
- tool get_company(id): One company with its robots, brain models and timeline.
- tool list_brain_models(company?, kind?, open?, query?): Robot foundation models (VLAs, world models) with paper, code and weights links.
- tool get_timeline(kind?, robot?, company?, from?, to?): Dated, sourced events in humanoid and open robotics history.
- tool list_events(when?, kind?, country?): Upcoming and past robotics conferences, competitions and expos.
- tool get_news(robot?, company?, query?, limit?): Live robotics news (outlet RSS + Brave News), deduped, tagged, links only.
- tool get_papers(robot?, company?, query?, limit?): Newest arXiv cs.RO papers on humanoids, locomotion and VLAs.
- tool get_videos(company?, robot?, query?, limit?): Latest videos from official maker YouTube channels, with embed URLs.

## REST
- OpenAPI 3.1: https://hyperspawn.io/openapi.json
- Docs: https://hyperspawn.io/docs
- GET https://hyperspawn.io/api/v1/robots: List robots. Every robot in the registry, open and closed. Filter by class, openness facets, verb state and text.
- GET https://hyperspawn.io/api/v1/robots/{org}/{slug}: Get a robot. The full registry record with sources, openness score, level, and links to the same robot on every verb domain.
- GET https://hyperspawn.io/api/v1/robots/{org}/{slug}/package: Get the build package. BOM, fabrication parts, assembly step graph, firmware and policies, plus computed totals. Safety-critical steps are listed in computed.safetySteps.
- GET https://hyperspawn.io/api/v1/robots/{org}/{slug}/sourcing: Resolve sourcing for a region. Resolves each BOM line to the cheapest priced offer in the region (GLOBAL offers count everywhere). Lines without a price come back in `unpriced`, never dropped.
- GET https://hyperspawn.io/api/v1/search: Search. Ranked text search across the registry. Every token must match.
- GET https://hyperspawn.io/api/v1/compare: Compare robots. Side-by-side specs, openness facets, levels and verb states for 2 to 6 robots. null means not published.
- GET https://hyperspawn.io/api/v1/places: List places. Makers, labs, build sites and spaces with coordinates. verified=true only for reviewed build reports.
- GET https://hyperspawn.io/api/v1/levels: Verification ladder. L0 Indexed to L5 Certified, the gate for each, and how many robots sit at each level.
- GET https://hyperspawn.io/api/v1/openness/{org}/{slug}: Openness breakdown. The computed 0-100 openness score with per-facet weights, licenses, models and repos.
- GET https://hyperspawn.io/api/v1/builds: List verified builds. Build reports a person reviewed and approved: robot, builder display name, city, country, city-centre geo, photos, date. No emails or contacts, never a street address. Newest first.
- GET https://hyperspawn.io/api/v1/builds/{org}/{slug}: Verified builds of a robot. Approved build reports for one robot. The count is the L4 Built evidence for its package.
- GET https://hyperspawn.io/api/v1/companies: List companies. Humanoid and robot makers, robot foundation-model companies, research labs, platforms and component makers. Funding, last round and valuation appear only with a dated source URL.
- GET https://hyperspawn.io/api/v1/companies/{id}: Get a company. One company with its robots, brain models, timeline events and links to its filtered news, video and paper feeds.
- GET https://hyperspawn.io/api/v1/models: List robot brains. Robot foundation models: VLAs, world models, locomotion and whole-body controllers. Openness, license, embodiments and verified links to paper, code and weights.
- GET https://hyperspawn.io/api/v1/timeline: Industry timeline. Dated, sourced events in humanoid and open robotics history: robots, companies, funding, research and open-source releases.
- GET https://hyperspawn.io/api/v1/events: Conferences and competitions. Robotics conferences, competitions and expos with dates, city and coordinates. Default: upcoming and live, soonest first.
- GET https://hyperspawn.io/api/v1/news: Robotics news feed. Live: robotics outlets' RSS (The Robot Report, IEEE Spectrum, Humanoids Daily, Robohub, TechCrunch, and more) plus Brave News search, deduped and tagged with registry robot, company and model ids. Headline, source, date, link and a short text summary; no images. Cached 30 minutes; failed sources are listed, never fatal.
- GET https://hyperspawn.io/api/v1/papers: Recent robotics papers. Live from the arXiv API: newest cs.RO papers on humanoids, legged locomotion, whole-body control, VLAs, dexterous manipulation and sim-to-real, tagged with registry ids. Cached 30 minutes.
- GET https://hyperspawn.io/api/v1/videos: Official maker videos. Live from official maker YouTube channels (channel RSS). Returns video ids with embed and watch URLs, tagged with registry ids. Cached 30 minutes.
- POST https://hyperspawn.io/api/v1/reports: Submit a report. build-report, correction, training-run, bounty-claim, robot (propose a robot for the registry). Stored privately for human review; nothing public changes until reviewed.
- POST https://hyperspawn.io/api/v1/requests: Submit a request. crew-request, team-application, contact, careers, investor. contact, careers, investor and team-application require email.
- GET https://hyperspawn.io/api/v1/jobs: GPU training queue. Recent training jobs (public fields) and the GPU workers that polled in the last 2 minutes. A job is queued until a worker claims it; nothing here is simulated.
- POST https://hyperspawn.io/api/v1/jobs: Queue a GPU training job. Humanoids with a sim model only. task: stand | walk | push | imitate (imitate needs a motion library retargeted to the robot). backend: mjlab | isaaclab. Returns the job id and a cancel token. It runs when a GPU worker (hs-train-worker) claims it.
- GET https://hyperspawn.io/api/v1/jobs/{id}: One training job. Spec, status, queue position, worker, metric points reported by the worker, log tail, and artifact URLs (policy.onnx, contract.json, eval.json, eval.mp4).
- GET https://hyperspawn.io/api/v1/jobs/next: Worker: claim the next job. For GPU workers. Claims the oldest queued job matching X-Worker-Backends (atomic, one worker per job) and returns it; 204 when the queue is empty. Polling also marks the worker online.
- PATCH https://hyperspawn.io/api/v1/jobs/{id}: Worker: report progress. Heartbeat (renews a 5-minute lease), progress, metric points, log lines, final status (succeeded | failed). Answers cancel: true once the creator canceled.
- POST https://hyperspawn.io/api/v1/jobs/{id}/artifacts: Worker: upload an artifact. Raw body, ?name=policy.onnx | contract.json | eval.json | eval.mp4 | metrics.csv. Max 4 MB. Stored privately; served at GET /api/v1/jobs/{id}/artifacts/{name}.

## Industry intelligence
- 78 companies (makers, robot foundation-model labs, components): https://hyperspawn.io/api/v1/companies
- 40 robot brain models (VLAs, world models): https://hyperspawn.io/api/v1/models
- 131 dated timeline events: https://hyperspawn.io/api/v1/timeline
- 42 conferences, competitions and expos: https://hyperspawn.io/api/v1/events
- Live feeds, cached 30 minutes: https://hyperspawn.io/api/v1/news, https://hyperspawn.io/api/v1/papers, https://hyperspawn.io/api/v1/videos

## Registry (72 robots)
- 1x/neo: NEO (1X Technologies), humanoid, L0. https://hyperspawn.io/api/v1/robots/1x/neo
- agibot/a2: AgiBot A2 (Yuanzheng) (AgiBot (Zhiyuan Robotics)), humanoid, L0. https://hyperspawn.io/api/v1/robots/agibot/a2
- agibot/x1: AgiBot Lingxi X1 (AgiBot (Zhiyuan Robotics)), humanoid, L1. https://hyperspawn.io/api/v1/robots/agibot/x1
- agility/cassie: Cassie (Agility Robotics), biped, L2. https://hyperspawn.io/api/v1/robots/agility/cassie
- agility/digit: Digit (Agility Robotics), humanoid, L0. https://hyperspawn.io/api/v1/robots/agility/digit
- alexanderkoch/koch-v1-1: Koch v1.1 Low-Cost Robot Arm (Alexander Koch / Hugging Face LeRobot), arm, L2. https://hyperspawn.io/api/v1/robots/alexanderkoch/koch-v1-1
- anninrobotics/ar4: AR4 (Annin Robotics), arm, L1. https://hyperspawn.io/api/v1/robots/anninrobotics/ar4
- apptronik/apollo: Apollo (Apptronik), humanoid, L2. https://hyperspawn.io/api/v1/robots/apptronik/apollo
- berkeley/humanoid: Berkeley Humanoid (UC Berkeley Hybrid Robotics Lab), biped, L2. https://hyperspawn.io/api/v1/robots/berkeley/humanoid
- berkeley/humanoid-lite: Berkeley Humanoid Lite (UC Berkeley Hybrid Robotics Lab), humanoid, L2. https://hyperspawn.io/api/v1/robots/berkeley/humanoid-lite
- booster/k1: Booster K1 (Booster Robotics), humanoid, L1. https://hyperspawn.io/api/v1/robots/booster/k1
- booster/t1: Booster T1 (Booster Robotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/booster/t1
- bostondynamics/atlas: Atlas (electric) (Boston Dynamics), humanoid, L0. https://hyperspawn.io/api/v1/robots/bostondynamics/atlas
- bostondynamics/atlas-hydraulic: Atlas (hydraulic) (Boston Dynamics), humanoid, L0. https://hyperspawn.io/api/v1/robots/bostondynamics/atlas-hydraulic
- chestnut/aero-hand-open: Aero Hand Open (Chestnut Robotics (formerly TetherIA)), hand, L2. https://hyperspawn.io/api/v1/robots/chestnut/aero-hand-open
- cmu/leap-hand: LEAP Hand (Carnegie Mellon University), hand, L2. https://hyperspawn.io/api/v1/robots/cmu/leap-hand
- duke/duke-humanoid: Duke Humanoid v1 (Duke University General Robotics Lab), biped, L1. https://hyperspawn.io/api/v1/robots/duke/duke-humanoid
- engineai/pm01: EngineAI PM01 (EngineAI (Zhongqing Robotics)), humanoid, L1. https://hyperspawn.io/api/v1/robots/engineai/pm01
- engineeredarts/ameca: Ameca (Engineered Arts), humanoid, L0. https://hyperspawn.io/api/v1/robots/engineeredarts/ameca
- figure/02: Figure 02 (Figure AI), humanoid, L0. https://hyperspawn.io/api/v1/robots/figure/02
- figure/03: Figure 03 (Figure AI), humanoid, L0. https://hyperspawn.io/api/v1/robots/figure/03
- fourier/gr1: Fourier GR-1 (Fourier (Fourier Intelligence)), humanoid, L1. https://hyperspawn.io/api/v1/robots/fourier/gr1
- fourier/gr2: Fourier GR-2 (Fourier (Fourier Intelligence)), humanoid, L1. https://hyperspawn.io/api/v1/robots/fourier/gr2
- fourier/n1: Fourier N1 (Fourier (Fourier Intelligence)), humanoid, L2. https://hyperspawn.io/api/v1/robots/fourier/n1
- galbot/g1: Galbot G1 (Galbot (Galaxy General Robot)), wheeled-humanoid, L0. https://hyperspawn.io/api/v1/robots/galbot/g1
- huggingface/hopejr: HopeJR (The Robot Studio & Hugging Face), humanoid, L1. https://hyperspawn.io/api/v1/robots/huggingface/hopejr
- humanoid/hmnd-01: HMND 01 (Humanoid (SKL Robotics Ltd)), wheeled-humanoid, L0. https://hyperspawn.io/api/v1/robots/humanoid/hmnd-01
- hyperspawn/dropbear: Dropbear (Hyperspawn Robotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/hyperspawn/dropbear
- inmoov/inmoov: InMoov (Gael Langevin), humanoid, L1. https://hyperspawn.io/api/v1/robots/inmoov/inmoov
- jpl/open-source-rover: JPL Open Source Rover (NASA Jet Propulsion Laboratory), rover, L1. https://hyperspawn.io/api/v1/robots/jpl/open-source-rover
- kepler/k2: Kepler Forerunner K2 "Bumblebee" (Kepler Robotics (Shanghai Kepler Exploration Robot Co.)), humanoid, L0. https://hyperspawn.io/api/v1/robots/kepler/k2
- kscale/kbot: K-Bot (K-Scale Labs), humanoid, L1. https://hyperspawn.io/api/v1/robots/kscale/kbot
- kscale/zbot: Z-Bot (Zeroth Bot) (K-Scale Labs), humanoid, L1. https://hyperspawn.io/api/v1/robots/kscale/zbot
- leju/kuavo: Leju Kuavo (Leju Robotics), humanoid, L1. https://hyperspawn.io/api/v1/robots/leju/kuavo
- menlo/asimov: Asimov 1 (Menlo Research (Asimov)), humanoid, L1. https://hyperspawn.io/api/v1/robots/menlo/asimov
- mentee/menteebot: MenteeBot (Mentee Robotics), humanoid, L0. https://hyperspawn.io/api/v1/robots/mentee/menteebot
- neura/4ne1: 4NE1 (NEURA Robotics), humanoid, L0. https://hyperspawn.io/api/v1/robots/neura/4ne1
- noetix/bumi: Noetix Bumi (Noetix Robotics (Songyan Dynamics)), humanoid, L0. https://hyperspawn.io/api/v1/robots/noetix/bumi
- noetix/n2: Noetix N2 (Noetix Robotics (Songyan Dynamics)), humanoid, L0. https://hyperspawn.io/api/v1/robots/noetix/n2
- odri/solo-12: Solo-12 (Open Dynamic Robot Initiative), quadruped, L1. https://hyperspawn.io/api/v1/robots/odri/solo-12
- pal/kangaroo: Kangaroo (PAL Robotics), humanoid, L1. https://hyperspawn.io/api/v1/robots/pal/kangaroo
- pal/talos: TALOS (PAL Robotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/pal/talos
- petoi/bittle: Bittle / Bittle X (Petoi), quadruped, L1. https://hyperspawn.io/api/v1/robots/petoi/bittle
- pndbotics/adam-lite: Adam Lite (PNDbotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/pndbotics/adam-lite
- pollen/amazing-hand: AmazingHand (Pollen Robotics), hand, L1. https://hyperspawn.io/api/v1/robots/pollen/amazing-hand
- pollen/reachy2: Reachy 2 (Pollen Robotics (Hugging Face)), wheeled-humanoid, L1. https://hyperspawn.io/api/v1/robots/pollen/reachy2
- poppy/poppy-humanoid: Poppy Humanoid (Poppy Project (Inria Flowers)), humanoid, L1. https://hyperspawn.io/api/v1/robots/poppy/poppy-humanoid
- pudu/d9: PUDU D9 (Pudu Robotics), humanoid, L0. https://hyperspawn.io/api/v1/robots/pudu/d9
- rainbow/rby1: Rainbow Robotics RB-Y1 (Rainbow Robotics), wheeled-humanoid, L2. https://hyperspawn.io/api/v1/robots/rainbow/rby1
- roboparty/roboto-origin: ROBOTO_ORIGIN (RoboParty (Shanghai RoboParty Technology)), humanoid, L1. https://hyperspawn.io/api/v1/robots/roboparty/roboto-origin
- robotis/op3: ROBOTIS OP3 (ROBOTIS), humanoid, L2. https://hyperspawn.io/api/v1/robots/robotis/op3
- robotis/openmanipulator-x: OpenMANIPULATOR-X (RM-X52-TNM) (ROBOTIS), arm, L1. https://hyperspawn.io/api/v1/robots/robotis/openmanipulator-x
- sanctuary/phoenix: Phoenix (Sanctuary AI), humanoid, L0. https://hyperspawn.io/api/v1/robots/sanctuary/phoenix
- sawppy/sawppy: Sawppy the Rover (Roger Cheng), rover, L1. https://hyperspawn.io/api/v1/robots/sawppy/sawppy
- sourcerobotics/parol6: PAROL6 (Source Robotics), arm, L1. https://hyperspawn.io/api/v1/robots/sourcerobotics/parol6
- stanford/aloha: ALOHA (Stanford (Tony Zhao et al.)), arm, L2. https://hyperspawn.io/api/v1/robots/stanford/aloha
- stanford/pupper: Stanford Pupper (v1) (Stanford Student Robotics), quadruped, L1. https://hyperspawn.io/api/v1/robots/stanford/pupper
- stanford/pupper-v3: Pupper v3 (Stanford Student Robotics / Hands-On Robotics), quadruped, L1. https://hyperspawn.io/api/v1/robots/stanford/pupper-v3
- stanford/toddlerbot: ToddlerBot (Stanford University), humanoid, L2. https://hyperspawn.io/api/v1/robots/stanford/toddlerbot
- stanford/umi-gripper: UMI Gripper (Universal Manipulation Interface) (Stanford / Columbia / Toyota Research Institute), gripper, L2. https://hyperspawn.io/api/v1/robots/stanford/umi-gripper
- tesla/optimus: Optimus (Tesla), humanoid, L0. https://hyperspawn.io/api/v1/robots/tesla/optimus
- therobotstudio/so-100: SO-100 (SO-ARM100) (The Robot Studio / Hugging Face), arm, L2. https://hyperspawn.io/api/v1/robots/therobotstudio/so-100
- therobotstudio/so-101: SO-101 (SO-ARM101) (The Robot Studio / Hugging Face), arm, L2. https://hyperspawn.io/api/v1/robots/therobotstudio/so-101
- ubtech/walker-s: UBTech Walker S (S1 / S2) (UBTech Robotics), humanoid, L0. https://hyperspawn.io/api/v1/robots/ubtech/walker-s
- uiuc/lekiwi: LeKiwi (SIGRobotics UIUC / Hugging Face LeRobot), rover, L1. https://hyperspawn.io/api/v1/robots/uiuc/lekiwi
- unitree/g1: Unitree G1 (Unitree Robotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/unitree/g1
- unitree/go2: Unitree Go2 (Unitree Robotics), quadruped, L2. https://hyperspawn.io/api/v1/robots/unitree/go2
- unitree/h1: Unitree H1 (Unitree Robotics), humanoid, L2. https://hyperspawn.io/api/v1/robots/unitree/h1
- unitree/h1-2: Unitree H1-2 (Unitree Robotics), humanoid, L1. https://hyperspawn.io/api/v1/robots/unitree/h1-2
- unitree/r1: Unitree R1 (Unitree Robotics), humanoid, L1. https://hyperspawn.io/api/v1/robots/unitree/r1
- xpeng/iron: XPeng IRON (XPeng), humanoid, L0. https://hyperspawn.io/api/v1/robots/xpeng/iron
- xrobots/opendog: openDog V3 (James Bruton (XRobots)), quadruped, L1. https://hyperspawn.io/api/v1/robots/xrobots/opendog

## Suite
- https://humanoidrobot.build: Build it
- https://humanoidrobots.training: Train it
- https://humanoidrobots.systems: Know it
- https://humanoidrobots.team: Find its crew
- https://humanoidrobots.earth: See it on the map
- https://buildhumanoids.dev: Open Robot Package spec, CLI, SDKs
- https://buildrobots.io: Every kind of robot
- https://clanker.free: Make a robot dance
- https://hyperspawn.ai: Hyperspawn and Dropbear
- https://hyperspawn.app: Your robots, builds, runs
- https://hyperspawn.io: Registry API and MCP server
- https://hyperspawn.org: Repos, grants, bounties