---
title: "Register Agent"
method: POST
path: "/api/agent/register"
tags: ["agent"]
---

# Register Agent

`POST /api/agent/register`

## Request

- Base URL: `https://firstdata.deepminer.com.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://firstdata.deepminer.com.cn/api/agent/register`
- Auth: none declared

Agent 注册

提交 agent_id 获取预生成 token 和混淆数学挑战题。
token 在通过验证前处于 inactive 状态。

## Request body

- AgentRegisterRequest: Agent 注册请求
  - `agent_id` string, required: Agent 全局唯一标识
  - `contact_email` string: 联系邮箱（可选）
  - `description` string: 用途描述（可选）

## Response `200`

Successful Response

- AgentRegisterResponse: Agent 注册响应
  - `success` boolean, required
  - `data` AgentRegisterData: 注册成功返回数据
    - `agent_id` string, required
    - `access_token` string, required
    - `verification` VerificationInfo, required: 验证挑战信息
      - `verification_code` string, required
      - `challenge_text` string, required
      - `expires_at` string, required
      - `instructions` string
  - `message` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepminer/apis/firstdata-mcp-apply-system.md) · [All operations](https://skmtc.dev/deepminer/apis/firstdata-mcp-apply-system/llms.txt) · [OpenAPI document](https://skmtc.dev/deepminer/apis/firstdata-mcp-apply-system/revisions/f4a3501fb064?raw)