# Truvera — how to use (mcp.ai)

Connect your Truvera account and use 15 tools for security and identity straight from your AI agent. Connect with your own API key. Truvera 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_truvera?ms=1787291340000`
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. `truvera_create_api_key`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/truvera`
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/truvera/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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/truvera/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 Truvera?"
- "Show me a summary of my Truvera account"

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