---
title: "Announce an agent (creates an unverified record or attaches to an existing one)"
method: POST
path: "/submit"
tags: ["submit"]
---

# Announce an agent (creates an unverified record or attaches to an existing one)

`POST /submit`

## Request

- Base URL: `https://wellknown.network/api/v1`
- URL: `https://wellknown.network/api/v1/submit`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- union
  - CardSubmission
    - `cardUrl` string, uri, required: URL of the agent's own /.well-known/agent-card.json
  - ManifestSubmission
    - `manifest` object, required
      - `name` string, required
      - `kind` 'agent' | 'mcp_server' | 'tool' | 'api'
      - `summary` string
      - `description` string
      - `homepage` string, uri
      - `repository` string, uri
      - `publisher` object
        - `name` string
        - `url` string
      - `protocols` string[]
      - `tags` string[]
      - `endpoints` object[], required
        - `url` string, required
        - `type` 'mcp_streamable_http' | 'mcp_sse' | 'a2a' | 'openapi' | 'http' | 'package_npm' | 'package_pypi', required
        - `auth` string
      - `pricing` object
      - `skills` object[]
        - `name` string
        - `description` string
        - `tags` string[]

## Response `200`

OK

- SubmissionResponse
  - `status` 'accepted' | 'duplicate'
  - `agent` object
    - `id` string
    - `handle` string
    - `url` string
  - `provenance` string
  - `verified` false
  - `claimUrl` string
  - `note` string

## Other responses

- `422`: Error
- `429`: Rate limited; see Retry-After and X-RateLimit-* headers.

---

[API](https://skmtc.dev/wellknown/apis/wellknown-api.md) · [All operations](https://skmtc.dev/wellknown/apis/wellknown-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wellknown/apis/wellknown-api/revisions/8a177fdcd434?raw)