# Dock Certs — how to use (mcp.ai)

Connect your Dock Certs account and use 15 tools for security and identity straight from your AI agent. Connect with your own API key. Dock Certs is a platform that enables organizations and developers to issue, manage, and verify verifiable credentials and decentralized identities, making data fraud-proof and instantly verifiable.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dock_certs?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dock_certs_create_api_key`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dock_certs`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dock_certs/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/dock_certs/create/api/key` — Tool to create an API key. Use when you need to generate a new API key with optional alias and IP allowlist.
  - body: { ips?: string[], alias?: string }
- `POST https://api.mcp.ai/api/dock_certs/create/webhook` — Tool to create a webhook endpoint. Use when you need Dock.io to push event notifications to your service.
  - body: { url: string, events: string[], status?: integer, description?: string }
- `POST https://api.mcp.ai/api/dock_certs/delete/api/key` — Tool to delete a specific API key. Use after confirming the API key's ID via list_api_keys.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/delete/credential` — Tool to delete a verifiable credential. Use after confirming the credential is no longer needed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/delete/tag` — Tool to delete a specific tag. Use when you have a tag ID and want to permanently remove it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/delete/webhook` — Tool to delete a specific webhook. Use after confirming the webhook's ID via list_webhooks.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/api/key` — Tool to retrieve details of an API key. Tries single-key endpoint first, then falls back to listing and filtering.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/api/keys` — Tool to list all API keys. Use when you need to retrieve all API keys for the authenticated account.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/credential` — Tool to retrieve a verifiable credential by its unique ID. If a password was used to persist it, include the same password to decrypt and return the full credential. Otherwise, only metadata is return
  - body: { id: string, password?: string }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/credentials` — Tool to retrieve a list of credential metadata. Use when you need to collect credential details with optional pagination or filtering after authentication.
  - body: { limit?: integer, filter?: string, offset?: integer }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/did` — Tool to retrieve a DID Document by its DID. Use after you have a valid DID to resolve and inspect its DID Document.
  - body: { did: string }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/registries` — Tool to retrieve a list of revocation registries. Use when you need to list all registries created by the authenticated account with optional pagination and filtering.
  - body: { did?: string, type?: string, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/webhook` — Tool to retrieve a specific webhook's details. Use after confirming you have a valid webhook ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/dock_certs/retrieve/webhooks` — Tool to list configured webhooks. Use when you need to retrieve all webhook endpoints configured for your account.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/dock_certs/verify` — Tool to verify a verifiable credential or presentation. Use after receiving a credential or presentation from an issuer.
  - body: { credential: object|string }

## Example prompts
- "What can I do in Dock Certs?"
- "Show me a summary of my Dock Certs account"

## More
- Page: https://mcp.ai/dock_certs
- Agent spec (llms.txt): https://mcp.ai/dock_certs/llms.txt
- Postman collection: https://mcp.ai/dock_certs/postman.json
