For MCP Providers

Getting Started

Contact us to get onboarded
Verify your MCP endpoint
Get your API key
Start registering entities

Full Sync API

Send all your entities in one request. We handle the diff automatically: new entities are created, existing ones updated, and missing ones deleted.

POST https://api.dockai.co/v1/providers/sync
Authorization: Bearer sk_live_xxxxxxxxxxxxx

Request Body

{
  "entities": [
    {
      "entity_id": "rest-123",
      "name": "Example Restaurant Paris",
      "domain": "example-restaurant.com",
      "category": "restaurant",
      "city": "Paris",
      "country": "FR"
    },
    {
      "entity_id": "rest-456",
      "name": "Another Restaurant",
      "category": "restaurant",
      "city": "Lyon"
    }
  ]
}

Entity Fields

Field	Required	Description
entity_id	Yes	Your internal ID
name	Yes	Display name
domain	No	Entity's website domain
path	No	Path within domain (e.g., /paris)
category	No	e.g., restaurant, hotel, salon
city, country	No	Location info
lat, lng	No	GPS coordinates
capabilities	No	What your MCP can do for this entity

Limits

Max 10,000 entities per request.
For larger imports, split your data into batches.

Response

{
  "success": true,
  "provider": "your-provider-id",
  "results": {
    "total": 2,
    "created": 1,
    "updated": 1,
    "deleted": 3,
    "unchanged": 0,
    "errors": 0
  }
}

Full Sync Behavior: Entities not in the request are automatically deleted. This keeps your registry in sync with your database.

Verification Levels

AI agents need to trust the MCP endpoints they connect to. Verification levels help agents assess how confident they can be that an entity is genuinely served by your MCP. Higher levels mean stronger proof of the relationship between the entity and the provider.

Level	Source	Trust
0	Provider registration only	Provider claim
1	Entity Card only OR Trusted Provider	Business claim
2	Both match	Dual attestation

Trusted Providers

Providers with established business partnerships can be marked as "trusted". Their entities start at Level 1 instead of Level 0, reflecting the existing business relationship.

Dual Attestation (Level 2)

When an entity you register also publishes an Entity Card with a matching endpoint, their verification level is upgraded to Level 2.

To help your clients set this up, provide them with an Entity Card template:

{
  "schema_version": "0.2.0",
  "domain": "example-restaurant.com",
  "entities": [
    {
      "name": "Client Business Name",
      "path": "/",
      "mcps": [
        {
          "provider": "your-provider-id",
          "endpoint": "https://your-mcp-endpoint.com"
        }
      ]
    }
  ]
}

Rate Limits

The sync endpoint is rate-limited to 100 requests per minute.

Alternative: Operations API

For granular control over individual entities, use the operations API with upsert/delete actions. This is useful when you only need to update a few entities without re-syncing the entire list.