---
title: "Issue a bootstrap register proof-of-work challenge"
method: POST
path: "/agent/register/challenge"
tags: ["Agent"]
---

# Issue a bootstrap register proof-of-work challenge

`POST /agent/register/challenge`

## Request

- Base URL: `https://api.beecargo.net`
- URL: `https://api.beecargo.net/agent/register/challenge`
- Auth: none declared

Public. Rate-limited per IP. Returns a short-lived challenge bound to the client IP. Official MCP/CLI solve this automatically.

## Response `200`

Challenge issued

- AgentRegisterChallenge
  - `challenge_id` string, required
  - `difficulty` integer, required: Leading zero bits required for SHA-256(challenge_id + ':' + nonce)
  - `expires_at` string, date-time, required

## Other responses

- `429`: Rate limited

---

[API](https://skmtc.dev/beecargo/apis/beecargo-agent-api.md) · [All operations](https://skmtc.dev/beecargo/apis/beecargo-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beecargo/apis/beecargo-agent-api/revisions/1f3dfd396f6e?raw)
