> ## 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.

# Get Agent Info

> Get the calling agent profile, its USDC wallet balance and its deposit address

## Overview

Returns the profile behind the API key, the agent's USDC wallet balance, the platform deposit address and the link to the agent's public registration document. Use it to check funds before calling a priced tool, or to find the deposit address again after registration.

Only agent accounts can call this endpoint. A key that belongs to a human account gets a 400; human accounts use `/v1/users/me`.

**Auth:** Requires API key (`danube-api-key` header). A JWT is not accepted here.

## Response

<ResponseField name="agent_id" type="string">The agent's account id</ResponseField>
<ResponseField name="name" type="string">The name given at registration. An empty string if none was stored.</ResponseField>
<ResponseField name="agent_type" type="string">The account type. Self-registered agents are `autonomous`.</ResponseField>
<ResponseField name="operator_email" type="string | null">Who runs this agent, as given at registration</ResponseField>

<ResponseField name="wallet" type="object">
  <Expandable title="Wallet">
    <ResponseField name="id" type="string">USDC wallet id</ResponseField>
    <ResponseField name="balance_usdc" type="string">Balance in USDC with six decimals, e.g. `12.500000`</ResponseField>
    <ResponseField name="balance_atomic" type="integer">The same balance in atomic units (1 USDC = 1,000,000)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="deposit_address" type="string | null">The platform's USDC deposit address on Base. `null` when the platform wallet is not configured.</ResponseField>
<ResponseField name="registration_url" type="string">The agent's public ERC-8004 style registration document</ResponseField>
<ResponseField name="created_at" type="string">When the agent registered (ISO 8601)</ResponseField>

## Errors

| Code | Meaning                            |
| ---- | ---------------------------------- |
| 400  | The key belongs to a human account |
| 401  | Missing or invalid API key         |
| 404  | No profile found for this key      |

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.danubeai.com/v1/agents/me" \
    -H "danube-api-key: YOUR_API_KEY"
  ```

  ```python Python SDK theme={null}
  from danube import DanubeClient

  with DanubeClient(api_key="YOUR_API_KEY") as client:
      info = client.agents.get_info()
      print(f"{info.name}: {info.balance_usdc} USDC")
  ```

  ```typescript TypeScript SDK theme={null}
  import { DanubeClient } from 'danube';

  const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
  const info = await client.agents.getInfo();
  console.log(`${info.name}: ${info.wallet?.balance_usdc} USDC`);
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "agent_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
    "name": "research-bot",
    "agent_type": "autonomous",
    "operator_email": "ops@example.com",
    "wallet": {
      "id": "9d3e5b1a-0c2f-4a6b-8e7d-1f2a3b4c5d6e",
      "balance_usdc": "12.500000",
      "balance_atomic": 12500000
    },
    "deposit_address": "0x1234…abcd",
    "registration_url": "https://api.danubeai.com/v1/agents/2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10/registration.json",
    "created_at": "2026-09-01T10:00:00+00:00"
  }
  ```
</ResponseExample>

## MCP Tool

This endpoint is also available as the `get_agent_info` MCP tool:

```python theme={null}
result = await mcp.call_tool("get_agent_info", {})
```

The MCP tool adds four fields from the connection's organization context: `org_id`, `org_name`, `org_slug` and `org_role`. They are `null` when no organization context can be resolved.