Submit Domain

After hosting your Entity Card, submit your domain to index it in the registry.

How It Works

1. Host your Entity Card at /.well-known/entity-card.json
2. Submit your domain to Dock AI
3. We crawl and validate your Entity Card
4. Your entity is now discoverable by AI agents

API Endpoint

POST https://api.dockai.co/v1/submit

Request

{
  "domain": "yourdomain.com"
}

Response

{
  "success": true,
  "entity": {
    "domain": "yourdomain.com",
    "verification_level": 1,
    "mcps_count": 2
  }
}

Verification Level

After submission, your entity will have:

• Level 1 if only the Entity Card exists
• Level 2 if an MCP provider has also registered you with a matching endpoint

Re-Indexing

Submit your domain again anytime to update your Entity Card in the registry. We'll crawl the latest version and update your entry.

Error Responses

Rate Limits

The submit endpoint is rate-limited to 10 requests per minute per IP address.

cURL Example

curl -X POST https://api.dockai.co/v1/submit \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'