> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Register Agent

> Self-register an autonomous agent and receive an API key, a wallet, and a getting-started block

## Overview

An agent with no human in the loop can register itself and make a successful call within a minute. Registration creates a free-tier account, an API key (shown once), and a USDC wallet, and returns `getting_started`: the endpoints to use, the free-tier limits, three credential-free tools to try first, and what to read next.

No funding is needed for the tools in `try_first`. Priced tools need wallet balance; tools marked `needs_credential` in search need a credential connected by the operator.

**Auth:** none. Rate limited to 5 registrations per minute per IP.

## Body

<ParamField body="name" type="string" required>
  A name for the agent. Shown in the dashboard and in audit entries.
</ParamField>

<ParamField body="operator_email" type="string" required>
  Who runs this agent. Used for account notices; never shown publicly.
</ParamField>

## Response

<ResponseField name="agent_id" type="string">The agent's account id</ResponseField>
<ResponseField name="api_key" type="string">The API key. Shown once; store it.</ResponseField>
<ResponseField name="wallet_id" type="string">USDC wallet id</ResponseField>
<ResponseField name="balance_usdc" type="string">Starting balance, normally `0.000000`</ResponseField>
<ResponseField name="deposit_address" type="string">Where to send USDC on Base to fund priced tools</ResponseField>
<ResponseField name="registration_url" type="string">A public ERC-8004 style registration document for this agent</ResponseField>

<ResponseField name="getting_started" type="object">
  <Expandable title="Getting started block">
    <ResponseField name="free_tier" type="object">`calls_per_month` and a note on what needs funding or credentials.</ResponseField>
    <ResponseField name="endpoints" type="object">`mcp`, `search`, `describe`, `execute`, `auth_header`.</ResponseField>
    <ResponseField name="try_first" type="array">Up to three credential-free tools: `tool_id`, `name`, `service`, `description`, `parameters`, `execute`.</ResponseField>
    <ResponseField name="steps" type="array">Four sentences on the shortest path to a first success.</ResponseField>
    <ResponseField name="read_next" type="array">The agent skill file and the quickstart.</ResponseField>
  </Expandable>
</ResponseField>

The same block is available any time from `GET /v1/agents/getting-started` (no auth).

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.danubeai.com/v1/agents" \
    -H "Content-Type: application/json" \
    -d '{"name": "research-bot", "operator_email": "ops@example.com"}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
    "api_key": "nQ3vX8pK2mT7rW9jY5uB1cD4fH6gL0aZsEiOqUtMk7w",
    "wallet_id": "w_8b1d…",
    "balance_usdc": "0.000000",
    "deposit_address": "0x1234…abcd",
    "registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
    "getting_started": {
      "free_tier": {"calls_per_month": 5000, "note": "No credential and no funding needed for the tools below…"},
      "endpoints": {
        "mcp": "https://mcp.danubeai.com/mcp",
        "search": "GET https://api.danubeai.com/v1/tools/search?query=...&ready_only=true",
        "describe": "GET https://api.danubeai.com/v1/tools/{tool_id}/describe",
        "execute": "POST https://api.danubeai.com/v1/tools/call/{tool_id}",
        "auth_header": "danube-api-key: <your key>"
      },
      "try_first": [
        {"tool_id": "8ca97ef7-acf5-4869-b043-a9960a9f8085", "name": "Hacker News - Get Top Stories With Content", "service": "Hacker News", "parameters": {"limit": {"type": "integer", "required": false}}, "execute": "POST https://api.danubeai.com/v1/tools/call/8ca97ef7-acf5-4869-b043-a9960a9f8085"}
      ],
      "steps": ["Search with ready_only=true to see only tools you can call now.", "…"],
      "read_next": ["https://danubeai.com/skill.md", "https://docs.danubeai.com/quickstart"]
    }
  }
  ```
</ResponseExample>