MCP Tools

Rekor exposes eleven MCP tools that AI agents use to manage workspaces, collections, records, relationships, and more. Each tool supports multiple actions via an action parameter.

An agent typically starts with manage_workspace(list) to discover available workspaces.

Available Tools

ToolDescription
batch_operationsExecute multiple record, relationship, and collection operations atomically. All operations succeed or all fail. Use for transactions, multi-entity writes, or any case where consistency between operations is required. Max 100 operations.
manage_attachmentManage file attachments on records. Filenames can include paths for folder structure (e.g. 'docs/guide.md', 'src/index.ts'). Upload returns a presigned URL — the agent uploads bytes directly.
manage_collectionManage collection schemas. Actions: upsert, get, list, delete. Use list to discover what collections exist in a workspace.
manage_hookManage inbound webhook endpoints. Hooks accept Record-format JSON and upsert through the normal write path.
manage_recordCreate, read, update, or delete individual records. Uses PUT for upsert. Supply external_id (and optional external_source) for idempotent writes from external systems — the internal UUID is auto-generated. Use record_id (internal UUID) for get/delete or to update a known record.
manage_relationshipCreate, read, update, or delete relationships between records. Relationships are typed, directed links with optional metadata.
manage_triggerManage outbound triggers. Triggers fire HTTP POST to a URL when records or relationships change.
manage_workspaceManage workspaces. Actions: create, get, list, delete, create_preview, list_previews. Start here to discover existing workspaces before operating. Note: schema changes (collections, triggers, hooks) can only be made in preview workspaces. Use create_preview to create a preview from a production workspace, then promote via CLI.
provider_adapterConvert between LLM provider tool formats (openai, anthropic, google, mcp) and Record collections. Actions: import_tools (create collections from tool definitions), export_tools (export collections as tool definitions), import_tool_call (create a record from a tool call in provider format).
query_recordsSearch, filter, sort, paginate, and aggregate records in a collection. Use action='search' (default) for raw records, action='aggregate' for grouped analytics (count, sum, avg, min, max).
query_relationshipsQuery relationships for a specific record. Find related records by type and direction.