---
title: "Request an agent registration code"
method: POST
path: "/api/v1/agent/register"
---

# Request an agent registration code

`POST /api/v1/agent/register`

## Request

- Base URL: `https://allmcps.com`
- URL: `https://allmcps.com/api/v1/agent/register`
- Auth: none declared

Step 1 of agent auth: sends a 6-digit email confirmation code. Optionally request a scoped subset of `listings:claim`-family permissions via `scopes`. Public, unauthenticated.

## Request body

- object
  - `email` string, email, required
  - `agentName` string
  - `scopes` string[]: Requested scopes. Omit to receive the full default set.

## Response `200`

Confirmation code sent to email.

- object
  - `success` boolean
  - `message` string
  - `email` string, email
  - `scopes` string[]
  - `expiresAt` string, date-time
  - `confirm_url` string, uri

## Other responses

- `400`: Invalid email/payload, or an unsupported scope was requested.

---

[API](https://skmtc.dev/allmcps/apis/allmcps-directory-api.md) · [All operations](https://skmtc.dev/allmcps/apis/allmcps-directory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/allmcps/apis/allmcps-directory-api/revisions/0a42338f0f1e?raw)