# Rkvst — how to use (mcp.ai)

Connect your Rkvst account and use 24 tools for security and identity straight from your AI agent. Connect with your own API key. DataTrails provides an evidence management platform that delivers a reliable chain of custody for supply chain data, ensuring data authenticity and transparency.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_rkvst?ms=1787293500000`
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. `rkvst_download_event_attachment`).

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

### Endpoints
- `POST https://api.mcp.ai/api/rkvst/download/event/attachment` — Tool to download an attachment from a specified Event on an Asset. Use when you have asset_uuid, event_uuid, and attachment uuid, and want the raw binary content.
  - body: { uuid: string, asset_uuid: string, event_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/get/app/registration` — Tool to retrieve details for a given App Registration ID. Use after obtaining the application's UUID to inspect its configuration and credentials.
  - body: { app_registration_id: string }
- `POST https://api.mcp.ai/api/rkvst/get/asset` — Tool to retrieve details for a given Asset. Use after you have its UUID; set `at_time` to get historical state.
  - body: { at_time?: string, asset_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/get/blob` — Tool to retrieve details of a Blob by ID. Use after confirming the Blob ID.
  - body: { blob_id: string, asset_uuid?: string }
- `POST https://api.mcp.ai/api/rkvst/get/event` — Tool to retrieve details of a specified Event. Use when you need full metadata, attributes, and associated trails of an existing event in DataTrails.
  - body: { event_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/get/iam/subject` — Tool to retrieve IAM subject details. Use when you need to fetch details for a specific IAM subject by its ID.
  - body: { subject_id: string }
- `POST https://api.mcp.ai/api/rkvst/get/member` — Tool to retrieve details for a given Member ID. Use after obtaining a valid member UUID.
  - body: { member_id: string }
- `POST https://api.mcp.ai/api/rkvst/get/public/asset` — Tool to retrieve details for a public asset. Use when you have a public asset UUID.
  - body: { uuid: string }
- `POST https://api.mcp.ai/api/rkvst/get/public/asset/event` — Tool to retrieve a specific public asset event. Use when you have public asset and event UUIDs.
  - body: { uuid: string, asset_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/get/tenancy` — Tool to retrieve details for a specific tenancy. Use after you have a tenancy ID.
  - body: { tenancy_id: string }
- `POST https://api.mcp.ai/api/rkvst/list/app/registrations` — Tool to list all App Registrations. Use after acquiring a valid auth token to retrieve the applications registered under the tenant.
  - body: { page_token?: string }
- `POST https://api.mcp.ai/api/rkvst/list/asset/events` — Tool to list events for a specified asset. Use after confirming you have the asset UUID.
  - body: { order_by?: string, page_size?: integer, asset_uuid: string, page_token?: string, minimum_trust?: string, asset_attributes?: object, event_attributes?: object }
- `POST https://api.mcp.ai/api/rkvst/list/assets` — Tool to list all Assets with optional pagination and filters. Use when you need to retrieve asset metadata in batches via page_size and next_page_token.
  - body: { page_size?: integer, next_page_token?: string, proof_mechanism?: string, request_total_count?: boolean, attributes.arc_display_name?: string, attributes.arc_display_type?: string }
- `POST https://api.mcp.ai/api/rkvst/list/iam/subjects` — Tool to list IAM subjects. Use when you need to retrieve provider-managed subjects, optionally filtering by display name. Use after authenticating the tenant.
  - body: { order_by?: string, page_size?: integer, page_token?: string, display_name?: string, wallet_address?: string }
- `POST https://api.mcp.ai/api/rkvst/list/members` — Tool to list all tenant Members. Use when you need an overview of all users in your tenant.
  - body: { member_state?: string }
- `POST https://api.mcp.ai/api/rkvst/list/public/asset/events` — Tool to list events for a specific public asset. Use when you need to retrieve the event history of a public asset after confirming its public availability.
  - body: { uuid: string, page_token?: string }
- `POST https://api.mcp.ai/api/rkvst/list/public/assets` — Tool to list all Public Assets. Use when you need to retrieve all assets made public.
  - body: { page_size?: integer, page_token?: string }
- `POST https://api.mcp.ai/api/rkvst/list/tenancies` — Tool to list all tenancies. Use after authenticating to retrieve the tenancy records available to the current tenant.
  - body: { page_token?: string }
- `POST https://api.mcp.ai/api/rkvst/promote/member` — Tool to promote a tenant member to OWNER role. Use when you need to elevate permissions after verifying the member identity.
  - body: { member_id: string }
- `POST https://api.mcp.ai/api/rkvst/retrieve/asset/attachment/metadata` — Tool to retrieve metadata for an attachment on a specified Asset. Use after obtaining asset and attachment UUIDs.
  - body: { uuid: string, asset_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/retrieve/caps` — Tool to retrieve resource limit quotas for a specified service. Use when checking quota availability before provisioning resources.
  - body: { service: string }
- `POST https://api.mcp.ai/api/rkvst/retrieve/event/attachment/metadata` — Tool to retrieve metadata for an attachment on a specified Event. Use when you have asset_uuid, event_uuid, and attachment uuid and need details like size, hash, and scan status.
  - body: { uuid: string, asset_uuid: string, event_uuid: string }
- `POST https://api.mcp.ai/api/rkvst/search/events` — Tool to search events matching filter criteria with pagination. Use when retrieving events by OData filter and paging through large result sets.
  - body: { top?: integer, skip?: integer, filter?: string }
- `POST https://api.mcp.ai/api/rkvst/update/app/registration` — Tool to update an application's display name or custom claims. Use after retrieving an App Registration to apply partial updates to its configuration.
  - body: { display_name?: string, custom_claims?: object, app_registration_id: string }

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

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