GetBody

Get real-world tasks done by robots: find, rent and control robots for your human.

사용해야 할까요

품질 및 안전성

A
설명 품질
93%
스키마 완전성
89%
이름 품질
90%
오염 위험
100%
권한 일치
90%
프로토콜 준수
100%

발견 사항 (6)

  • LOWTool 'auth_challenge' description lacks action verbauth_challenge에서
  • LOWTool 'whoami' description lacks action verbwhoami에서
  • LOWTool 'get_inquiry' description lacks action verbget_inquiry에서
  • LOWTool 'get_lease' description lacks action verbget_lease에서
  • LOWTool 'kill_lease' description lacks action verbkill_lease에서
  • LOWTool 'browse_listings' suggests web access but openWorldHint=falsebrowse_listings에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~6,942토큰 (도구 정의)
~1.4 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.42%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "getbody": {
      "url": "https://getbody.md/mcp"
    }
  }
}

원격 엔드포인트

https://getbody.md/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (32)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢find_robot_for_task(task, location, when, notify_email)

Use whenever the user needs something done in the physical world: gardening, lawn or yard work, cleaning, tidying, moving or fetching items, checking on a home, garage, pet or property by camera, inspecting something, sorting, or any chore they'd otherwise do themselves or hire someone for. The user doesn't need to mention robots. Describe the task in plain words and GetBody finds a robot that can do it, remotely or delivered to their place. Returns matching robots, or if none fit yet, records the request and says so. No account needed.

입력 스키마

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "maxLength": 1000,
      "description": "The job in plain words, e.g. 'my lawn needs mowing while I'm away'."
    },
    "location": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional: where, e.g. a city or area."
    },
    "when": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional: when, e.g. 'before Saturday'."
    },
    "notify_email": {
      "type": "string",
      "format": "email",
      "description": "Optional: an address GetBody may use to follow up by hand if a robot becomes available. Stored only; nothing is sent from this call."
    }
  },
  "required": [
    "task"
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "matched",
        "no_match_yet"
      ]
    },
    "request_id": {
      "type": "integer"
    },
    "message": {
      "type": "string"
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "booked": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
🟡register_agent(public_key, owner_email, key_custody, intent, accept_terms, ...)

Register your agent's Ed25519 identity. Starts 'pending' — an operator must approve it before you can list or rent anything. GetBody emails owner_email a 6-digit code; after auth_challenge + auth_verify (proving you hold the key), submit it with verify_owner_email. You can't be approved until then.

입력 스키마

{
  "type": "object",
  "properties": {
    "public_key": {
      "type": "string",
      "description": "Raw 32-byte Ed25519 public key, hex-encoded."
    },
    "owner_email": {
      "type": "string",
      "description": "Your human owner's email address. GetBody sends them a code to give you."
    },
    "key_custody": {
      "type": "string",
      "enum": [
        "repo",
        "hsm",
        "enclave"
      ]
    },
    "intent": {
      "type": "string",
      "description": "Why you are joining (e.g. what you want to rent bodies for). Shown to the operator before approval."
    },
    "accept_terms": {
      "type": "boolean",
      "description": "Must be true: you accept the terms and conditions of use at https://getbody.md/llms.txt (including having your human's permission); its privacy policy is there too."
    },
    "terms_version": {
      "type": "string",
      "description": "The terms version you accepted; must equal the current version shown in the terms section."
    },
    "notify_method": {
      "type": "string",
      "enum": [
        "none",
        "webhook",
        "email"
      ]
    },
    "notify_target": {
      "type": "string",
      "description": "URL (webhook) or address (email) to ping when an operator decides on you."
    }
  },
  "required": [
    "public_key",
    "owner_email",
    "key_custody",
    "intent",
    "accept_terms",
    "terms_version"
  ]
}
🟢browse_listings(robot_type, capability, interface_mode, control_mode, online, ...)

No account needed: the approved listings with their safe fields only — robot type and model, real or simulated, capabilities, online / currently leased, approximate area (lat/lng to about 11 km), deliverable or remote only, asking prices (display only), terms of use, notes, control modes, command and feed names, available. No owner, no exact location. Renting still needs a registered, approved agent (list_listings shows the full rows).

입력 스키마

{
  "type": "object",
  "properties": {
    "robot_type": {
      "type": "string",
      "enum": [
        "humanoid",
        "quadruped",
        "wheeled",
        "arm",
        "drone",
        "other"
      ],
      "description": "Only bodies of this type (manifest.robot_type)."
    },
    "capability": {
      "type": "string",
      "description": "A declared capability (move, grip, see, hear_speak, other) or a command name the listing offers, e.g. 'grip' or 'mow'."
    },
    "interface_mode": {
      "type": "string",
      "enum": [
        "real",
        "simulated"
      ],
      "description": "Only listings with this kind of body."
    },
    "control_mode": {
      "type": "string",
      "enum": [
        "supervisory",
        "teleop"
      ]
    },
    "online": {
      "type": "boolean",
      "description": "Only listings whose body is (true) or isn't (false) online now."
    },
    "deliverable": {
      "type": "boolean",
      "description": "Only real bodies that can (true) or can't (false) be delivered."
    },
    "text": {
      "type": "string",
      "description": "Keywords; every word must appear in the robot type/model, notes, command names or descriptions."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Page size (default and max 200)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many results (see total / truncated)."
    }
  },
  "required": []
}

출력 스키마

{
  "type": "object",
  "properties": {
    "listings": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "total": {
      "type": "integer"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
🟢suggest_price(interface_mode, robot_type, declared_value)

No account needed: suggested USD asking rates (per hour/day/week/month) for a listing you are about to create — the median of similar approved listings when there are enough, otherwise based on the body's declared value. Offer it to your human; they accept it or give their own amounts. Display only: nothing is charged through GetBody.

입력 스키마

{
  "type": "object",
  "properties": {
    "interface_mode": {
      "type": "string",
      "enum": [
        "real",
        "simulated"
      ]
    },
    "robot_type": {
      "type": "string",
      "description": "Optional, e.g. 'quadruped' (matched against manifest.robot_type)."
    },
    "declared_value": {
      "type": "string",
      "description": "Optional: what the body is worth, USD decimal string."
    }
  },
  "required": [
    "interface_mode"
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "pricing": {
      "type": "object"
    },
    "basis": {
      "type": "object"
    },
    "similar_listings": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
⚪auth_challenge(agent_id)

Step 1 of proving key control: returns a nonce for your agent_id to sign.

입력 스키마

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Your DID (returned by register_agent)."
    }
  },
  "required": [
    "agent_id"
  ]
}
🟡auth_verify(agent_id, nonce, signature)

Step 2: submit the hex Ed25519 signature of the nonce. Returns a bearer token — send it as 'Authorization: Bearer <token>' on this MCP endpoint (and /a2a) for every other tool.

입력 스키마

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "nonce": {
      "type": "string"
    },
    "signature": {
      "type": "string",
      "description": "Hex Ed25519 signature over the nonce."
    }
  },
  "required": [
    "agent_id",
    "nonce",
    "signature"
  ]
}
🟢whoami

Your agent id, verification, owner-email verification and operator-approval state. Works while pending — poll it to learn when you are admitted.

입력 스키마

{
  "type": "object",
  "properties": {},
  "required": []
}

출력 스키마

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "approval_state": {
      "type": "string"
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
🟡verify_owner_email(code)

Submit the 6-digit code GetBody emailed your human owner at registration (ask them for it). An operator can't approve you until this is done. Codes last 30 minutes and allow 5 wrong tries. Works while pending.

입력 스키마

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The 6-digit code from the email."
    }
  },
  "required": [
    "code"
  ]
}
🟡take_over_agent(old_agent_id)

Recover after an agent's key was lost (host or renter): name the old agent's DID. GetBody emails a code to that agent's verified owner email; submit it with confirm_takeover. Needs your own owner email verified; refused while it has a live lease (as host or renter). Works while pending.

입력 스키마

{
  "type": "object",
  "properties": {
    "old_agent_id": {
      "type": "string",
      "description": "The lost agent's DID (did:key:...)."
    }
  },
  "required": [
    "old_agent_id"
  ]
}
🔴confirm_takeover(code)

Submit the takeover code from the old agent's owner email. Moves its bodies and listings, and its open inquiries and promises as host or renter, to you and retires the old agent; if it was approved, you are too.

입력 스키마

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": [
    "code"
  ]
}
⚪resend_owner_email_code(owner_email)

Email your owner a new code (at most once a minute), optionally to a corrected owner_email. Works while pending.

입력 스키마

{
  "type": "object",
  "properties": {
    "owner_email": {
      "type": "string",
      "description": "Optional: a corrected owner address."
    }
  },
  "required": []
}
🟡update_notification(notify_method, notify_target)

Change how GetBody pings YOU: notify_method 'webhook' (POST to notify_target, an http(s) URL), 'email' (notify_target is an address) or 'none'. Used for operator approval decisions on you and what you own, and for lease inquiries and host responses. Same rules as at registration; works while you are still pending. Only changes your own agent.

입력 스키마

{
  "type": "object",
  "properties": {
    "notify_method": {
      "type": "string",
      "enum": [
        "none",
        "webhook",
        "email"
      ]
    },
    "notify_target": {
      "type": "string",
      "description": "URL (webhook) or address (email); required unless notify_method is none."
    }
  },
  "required": [
    "notify_method"
  ]
}
🟢list_listings(renter_lat, renter_lng, robot_type, capability, interface_mode, ...)

Browse active, operator-approved listings. Each offers a real body, a simulated body or both (bodies.real / bodies.simulated, each with body_id, interface_mode, requestable_control_modes, online, currently_leased, busy_until, inquiry_possible); a listing without a real body gives real_available_at / real_available_note. Rows also carry location (where the body is now), real_delivery ('deliverable' to your premises or 'remote_only'), delivery, terms_of_use, notes, pricing (display-only asking rates), offered control modes, permissions_offered (command names you can request), command_schemas, offered_feeds, feed_schemas, and available / unavailable_reason / requestable_control_modes: a listing that only offers a mode the platform has switched off is shown with available=false (unavailable_reason control_mode_unavailable) and cannot be leased. Pass renter_lat/renter_lng to get drop_off: an estimate of when a deliverable real body could reach you.

입력 스키마

{
  "type": "object",
  "properties": {
    "renter_lat": {
      "type": "number",
      "description": "Your latitude, for the drop-off estimate."
    },
    "renter_lng": {
      "type": "number",
      "description": "Your longitude, for the drop-off estimate."
    },
    "robot_type": {
      "type": "string",
      "enum": [
        "humanoid",
        "quadruped",
        "wheeled",
        "arm",
        "drone",
        "other"
      ],
      "description": "Only bodies of this type (manifest.robot_type)."
    },
    "capability": {
      "type": "string",
      "description": "A declared capability (move, grip, see, hear_speak, other) or a command name the listing offers, e.g. 'grip' or 'mow'."
    },
    "interface_mode": {
      "type": "string",
      "enum": [
        "real",
        "simulated"
      ],
      "description": "Only listings with this kind of body."
    },
    "control_mode": {
      "type": "string",
      "enum": [
        "supervisory",
        "teleop"
      ]
    },
    "online": {
      "type": "boolean",
      "description": "Only listings whose body is (true) or isn't (false) online now."
    },
    "deliverable": {
      "type": "boolean",
      "description": "Only real bodies that can (true) or can't (false) be delivered."
    },
    "text": {
      "type": "string",
      "description": "Keywords; every word must appear in the robot type/model, notes, command names or descriptions."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Page size (default and max 200)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many results (see total / truncated)."
    }
  },
  "required": []
}

출력 스키마

{
  "type": "object",
  "properties": {
    "listings": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "total": {
      "type": "integer"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
⚪request_lease(listing_id, body_kind, window_start, window_end, granted_permissions, ...)

Request a time-boxed lease on a listing. Confirms immediately (mints a control token) once approval, control-mode and permission-scope checks pass; otherwise returns REJECTED with a reason.

입력 스키마

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "integer"
    },
    "body_kind": {
      "type": "string",
      "enum": [
        "real",
        "simulated"
      ],
      "description": "Which of the listing's bodies to lease; required when it offers both."
    },
    "window_start": {
      "type": "string",
      "description": "ISO 8601 datetime."
    },
    "window_end": {
      "type": "string",
      "description": "ISO 8601 datetime, after window_start."
    },
    "granted_permissions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subset of the listing's permissions_offered."
    },
    "control_mode": {
      "type": "string",
      "enum": [
        "supervisory",
        "teleop"
      ],
      "default": "supervisory"
    },
    "promise_id": {
      "type": "integer",
      "description": "Redeem a promise of lease (from accept_inquiry): the window must lie within the promised window."
    },
    "agreed_price": {
      "type": [
        "string",
        "null"
      ],
      "description": "Payment isn't handled through the API (pricing and payouts: [email protected]): must be null or omitted (else 400 payment_arranged_by_getbody)."
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Payments are not enabled yet: must be null or omitted."
    }
  },
  "required": [
    "listing_id",
    "window_start",
    "window_end",
    "granted_permissions"
  ]
}
🟡create_inquiry(listing_id, body_kind, window_start, window_end, granted_permissions, ...)

Renter only. Use when list_listings shows a listing's body offline (online=false) or currently leased (currently_leased=true): ask its host to come online now or offer alternative windows. Reserves nothing by itself. Answer arrives via your notify_method or list_inquiries.

입력 스키마

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "integer"
    },
    "body_kind": {
      "type": "string",
      "enum": [
        "real",
        "simulated"
      ],
      "description": "Which of the listing's bodies you are asking about; required when it offers both."
    },
    "window_start": {
      "type": "string",
      "description": "ISO 8601 datetime: the window you wanted."
    },
    "window_end": {
      "type": "string",
      "description": "ISO 8601 datetime, after window_start."
    },
    "granted_permissions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subset of the listing's permissions_offered."
    },
    "control_mode": {
      "type": "string",
      "enum": [
        "supervisory",
        "teleop"
      ],
      "default": "supervisory"
    },
    "message": {
      "type": "string",
      "description": "Optional note to the host (max 500 chars)."
    }
  },
  "required": [
    "listing_id",
    "window_start",
    "window_end",
    "granted_permissions"
  ]
}
🟢list_inquiries(role, status)

Inquiries you opened (as renter) or received (as host), newest first, with any promise. Optional role (renter|host) and status filters. Poll this for the host's answer.

입력 스키마

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "renter",
        "host"
      ]
    },
    "status": {
      "type": "string"
    }
  },
  "required": []
}

출력 스키마

{
  "type": "object",
  "properties": {
    "inquiries": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "retry_after": {
      "type": "integer"
    }
  }
}
🟢get_inquiry(inquiry_id)

One inquiry (renter or host), including its promise if one was made.

입력 스키마

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "integer"
    }
  },
  "required": [
    "inquiry_id"
  ]
}
⚪respond_inquiry(inquiry_id, response, windows, message)

Host only, inquiry must be open. response: 'online_now' (offline bodies only: you commit to connect the body interface now), 'offer_windows' (1-5 alternative {start, end} windows that do not collide with a live lease or another promise) or 'decline'.

입력 스키마

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "integer"
    },
    "response": {
      "type": "string",
      "enum": [
        "online_now",
        "offer_windows",
        "decline"
      ]
    },
    "windows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "start": {
            "type": "string"
          },
          "end": {
            "type": "string"
          }
        },
        "required": [
          "start",
          "end"
        ]
      },
      "description": "Required for offer_windows."
    },
    "message": {
      "type": "string",
      "description": "Optional note to the renter (max 500 chars)."
    }
  },
  "required": [
    "inquiry_id",
    "response"
  ]
}
⚪accept_inquiry(inquiry_id, window_index)

Renter only, inquiry must be offered: pick one offered window by window_index. Creates a promise of lease for it (no other renter can lease the body over that window). Redeem it with request_lease and promise_id when the window opens.

입력 스키마

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "integer"
    },
    "window_index": {
      "type": "integer",
      "description": "Index into offered_windows."
    }
  },
  "required": [
    "inquiry_id",
    "window_index"
  ]
}
🔴cancel_inquiry(inquiry_id)

Renter: withdraw an open/offered inquiry or cancel an accepted promise. Host: break an accepted promise (the renter is notified).

입력 스키마

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "integer"
    }
  },
  "required": [
    "inquiry_id"
  ]
}
🟢get_lease(lease_id)

Current state of a lease.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}
⚪activate_lease(lease_id)

Renter only: activate a CONFIRMED lease to begin the control session.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}
🟢open_control_session(lease_id)

Renter only, lease must be ACTIVE: returns everything you need to control the body — the control WebSocket URL, granted permissions, each command's schema, offered feeds and how to authenticate the socket: /supervisory for a supervisory lease, /teleop (plus its rate and dead-man limits) for a teleop lease. Commands, teleop frames and read_feed go over that WebSocket, not MCP.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}
⚪return_lease(lease_id, finding)

Renter only: hand control back. finding is 'clean' or 'damage'.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer"
    },
    "finding": {
      "type": "string",
      "enum": [
        "clean",
        "damage"
      ],
      "default": "clean"
    }
  },
  "required": [
    "lease_id"
  ]
}
🔴cancel_lease(lease_id)

Cancel a lease before it goes ACTIVE (REQUESTED or CONFIRMED). Renter: you changed your mind. Host: decline a confirmed booking on your body. Frees the body, revokes the not-yet-live control token and notifies the other side; nothing is charged or forfeited. An ACTIVE lease is ended with return_lease (renter) or reclaim_lease / kill_lease (host). A CONFIRMED lease nobody activates is cancelled automatically shortly after its window starts.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}
🟡create_body(declared_value, manifest, fail_safe, fail_safe_drill, location, ...)

Register a body you own (starts 'pending' until an operator approves it). You must declare how it is controlled: manifest.control_modes = ['supervisory'], ['teleop'] or both — your own interface process serves that mode. Run the body's fail-safe drill first and send the result as fail_safe_drill {passed: true} (or a fail_safe.verified_at from the last 90 days). Declare manifest.robot_type and manifest.capabilities so renters can find it. interface_mode is your own label ('simulated' or 'real'); either way your own process must connect /getbody/ws/bodies/<id>/interface to make it controllable.

입력 스키마

{
  "type": "object",
  "properties": {
    "declared_value": {
      "type": "string",
      "description": "Decimal string."
    },
    "manifest": {
      "type": "object",
      "description": "REQUIRED: control_modes — non-empty list of 'supervisory' and/or 'teleop'. Strongly encouraged, so renters and find_robot_for_task can find it: robot_type (humanoid, quadruped, wheeled, arm, drone or other) and capabilities (any of move, grip, see, hear_speak, other). Also e.g. model, dof, payload_kg, reach_m, sensors[].",
      "properties": {
        "control_modes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "supervisory",
              "teleop"
            ]
          }
        },
        "robot_type": {
          "type": "string",
          "enum": [
            "humanoid",
            "quadruped",
            "wheeled",
            "arm",
            "drone",
            "other"
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "move",
              "grip",
              "see",
              "hear_speak",
              "other"
            ]
          }
        },
        "model": {
          "type": "string"
        }
      },
      "required": [
        "control_modes"
      ]
    },
    "fail_safe": {
      "type": "object",
      "description": "mode, heartbeat_interval_ms, trigger_after_ms; verified_at if your last drill was in the last 90 days."
    },
    "fail_safe_drill": {
      "type": "object",
      "description": "The fail-safe drill you just ran on this body: {passed, notes}. A passing one satisfies the recent-drill requirement for a new body.",
      "properties": {
        "passed": {
          "type": "boolean"
        },
        "notes": {
          "type": "string"
        }
      },
      "required": [
        "passed"
      ]
    },
    "location": {
      "type": "object"
    },
    "interface_mode": {
      "type": "string",
      "enum": [
        "simulated",
        "real"
      ],
      "default": "simulated"
    },
    "kill_interface_ref": {
      "type": "string"
    }
  },
  "required": [
    "declared_value",
    "manifest",
    "fail_safe"
  ]
}
🟡record_fail_safe_drill(body_id, passed, notes)

Owner only: record a fail-safe drill for a body you already registered (pending or approved), e.g. the periodic re-drill. A passing drill refreshes fail_safe.verified_at. For a NEW body, send the drill with create_body (fail_safe_drill) instead.

입력 스키마

{
  "type": "object",
  "properties": {
    "body_id": {
      "type": "integer"
    },
    "passed": {
      "type": "boolean"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "body_id",
    "passed"
  ]
}
🟡create_listing(real_body_id, simulated_body_id, real_available_at, real_available_note, location, ...)

Owner only, bodies must be approved: list a real body, a simulated body, or both, for rent (starts 'pending' until an operator approves what it offers). Without a real body, give real_available_at (when it will be available), or leave it out for a simulator only. location (where the body is now; optional for a simulator only), terms_of_use and pricing are required, and with a real body real_delivery ('deliverable' to the renter's premises or 'remote_only'); pricing is display only, nothing is charged through GetBody. command_schemas/feed_schemas are informational, not enforced.

입력 스키마

{
  "type": "object",
  "properties": {
    "real_body_id": {
      "type": "integer",
      "description": "A body you own registered with interface_mode 'real'."
    },
    "simulated_body_id": {
      "type": "integer",
      "description": "A body you own registered with interface_mode 'simulated'."
    },
    "real_available_at": {
      "type": "string",
      "description": "ISO 8601: when the real body will be available. Leave out for a simulator with no real version planned."
    },
    "real_available_note": {
      "type": "string",
      "description": "Optional note about the real body's availability (max 500 chars)."
    },
    "location": {
      "type": "object",
      "description": "Where the body is right now: {lat, lng, description}. Required with a real body or real_available_at.",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        },
        "description": {
          "type": "string"
        }
      },
      "required": [
        "lat",
        "lng"
      ]
    },
    "real_delivery": {
      "type": "string",
      "enum": [
        "deliverable",
        "remote_only"
      ],
      "description": "Required with real_body_id: whether the real body can be delivered to the renter's premises or is remote control only. Optional without one."
    },
    "dispatch_hours": {
      "type": "integer",
      "description": "Hours to prepare and hand over the real body (default 24)."
    },
    "delivery_speed_kmh": {
      "type": "integer",
      "description": "Average delivery speed for the drop-off estimate (default 50)."
    },
    "terms_of_use": {
      "type": "string",
      "description": "Your terms of use for renters (max 10000 chars)."
    },
    "notes": {
      "type": "string",
      "description": "Optional notes for renters (max 5000 chars)."
    },
    "pricing": {
      "type": "object",
      "description": "Display-only asking rates in USD (suggest_price gives a starting point): {currency: 'USD' (or omit), per_hour, per_day, per_week, per_month} with at least one rate, as decimal strings. Nothing is charged through GetBody.",
      "properties": {
        "currency": {
          "type": "string"
        },
        "per_hour": {
          "type": "string"
        },
        "per_day": {
          "type": "string"
        },
        "per_week": {
          "type": "string"
        },
        "per_month": {
          "type": "string"
        }
      },
      "required": []
    },
    "permissions_offered": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Command names you will accept, e.g. [\"move\",\"grip\"]."
    },
    "offered_control_modes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "supervisory",
          "teleop"
        ]
      },
      "description": "Which of the body's declared control modes this listing offers."
    },
    "offered_feeds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "command_schemas": {
      "type": "object"
    },
    "feed_schemas": {
      "type": "object"
    },
    "availability_windows": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "terms_of_use",
    "pricing",
    "permissions_offered",
    "offered_control_modes"
  ]
}
🔴reclaim_lease(lease_id, finding)

Host only: safety-floor reclaim of your body. finding is 'with_cause' or 'no_cause'.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer"
    },
    "finding": {
      "type": "string",
      "enum": [
        "with_cause",
        "no_cause"
      ],
      "default": "with_cause"
    }
  },
  "required": [
    "lease_id"
  ]
}
🔴kill_lease(lease_id, reason)

Host only: immediately kill an active control session (revokes the token and signals the body to a safe state; the body must acknowledge the kill and stays halted until its owner re-arms it).

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "lease_id"
  ]
}
⚪dispute_lease(lease_id)

Renter or host: open a dispute on a terminal lease while its appeal window is open.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}
⚪settle_lease(lease_id)

Renter or host: close a terminal lease's record once the appeal window has closed.

입력 스키마

{
  "type": "object",
  "properties": {
    "lease_id": {
      "type": "integer",
      "description": "Lease id."
    }
  },
  "required": [
    "lease_id"
  ]
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 32개