DUAL MCP Server

Execute an action on a tokenized object via the Event Bus. Actions are the primary way to change object state. Examples: mint tokens, transfer ownership, redeem rewards, update status. The action_type must match a registered action type, and the object must belong to a template that allows it.

Execute multiple actions atomically in a single batch. All actions succeed or all fail. Useful for complex operations like: mint + transfer + configure in one transaction.

List executed actions. Filter by action ID or template.

Get full details of a specific executed action.

List all registered action types. Action types define what operations can be performed on objects.

Register a new action type with an optional JSON schema for payload validation.

Update an action type's name, description, or payload schema.

List all API keys for the authenticated wallet.

Create a new API key for server-to-server integration. The key value is only shown once — save it immediately.

Permanently revoke and delete an API key.

Generate a complete token template design from a natural language description.

List all generated token designs with optional use case filter.

Get a specific token design by ID with full template specification.

Refine an existing token design — add/remove fields, adjust properties.

Delete a token design by ID.

Create a face template with SVG base and data bindings for dynamic token rendering.

List all face templates.

Render a face template with token data, producing HTML output.

List face definitions. Faces are visual representations (images, 3D models, web views) attached to templates.

Create a visual face for a template. Types: image, image_progress, image_policy, image_layered, 3d, web.

Get details of a specific face.

Update a face's display URL or type.

Delete a face definition.

Get all faces associated with a specific template.

Evaluate a token action against all enabled compliance rules. Returns pass/fail with violation details.

Create a new compliance rule (AML threshold, transfer limit, restricted wallet, or geographic).

List all compliance rules with optional filters.

Update a compliance rule by ID.

Delete a compliance rule by ID.

Retrieve compliance audit log entries.

Get compliance statistics: evaluations, pass rate, violations by type.

Parse a natural language policy description into structured compliance rules.

Get a parsed policy document by ID.

Validate a parsed policy for internal consistency.

Record the provenance of AI-generated content with SHA-256 hashing.

Retrieve a provenance record by ID.

Verify AI-generated content by re-hashing and comparing to the stored provenance record.

Generate a verification badge (certificate, seal, or QR) for a provenance record.

Create a new autonomous agent with condition/action rules for the DUAL Intelligence Service.

List all autonomous agents in the DUAL Intelligence Service.

Get details of a specific autonomous agent by ID.

Execute an agent, evaluating its rules against the provided context. Supports dry-run mode.

Bulk ingest action history records for lifecycle prediction analysis.

Get transfer likelihood, abandonment risk, and spike probability predictions for a specific object.

List objects ranked by recent activity score.

Detect anomalous activity patterns across all tracked objects.

Ingest template or token metadata into the knowledge graph.

Find nodes similar to a given node using metadata overlap, Jaccard, or cosine similarity.

Find all nodes connected to a given node within N hops using BFS.

Get ecosystem-wide analytics: topology, concentration, velocity, top hubs.

List notification messages sent through the platform.

Send a notification message to one or more wallets using a message template.

List all notification message templates.

Create a notification template with subject, body (with placeholders), and delivery channels.

Delete a message template.

List tokenized objects (asset instances). Objects are created from templates and owned by wallets. Filter by template, owner, FQDN, or geographic hash. Supports pagination.

Get full details of a tokenized object — its properties, ownership, faces, actions, and metadata.

Update the properties of a tokenized object. Only mutable properties can be changed.

Get child objects in a hierarchical object tree.

Get parent objects in a hierarchical object tree.

Get the full activity/audit log for an object — all state changes, transfers, and action executions.

Search tokenized objects with filter criteria. Supports complex queries across all object properties. Example filters: { "template_id": "abc123", "properties.status": "active" }

Count objects matching filter criteria without returning the full objects.

List all organizations the authenticated wallet belongs to. Supports pagination and role filtering.

Create a new organization (multi-tenant workspace). Returns the org with its ID and FQDN.

Get organization details including members, roles, and account info.

Update an organization's name, description, or image.

Get the current balance and currency for an organization.

List all members of an organization with their roles.

Add a wallet as a member to an organization with a specific role.

Remove a member from an organization.

List all roles defined for an organization.

Create a new role with specific permissions for an organization.

Get the platform's payment configuration — deposit addresses, supported tokens, and fee structure.

List deposit transactions. Filter by transaction hash, token, or token address.

List publicly accessible templates. No authentication required.

Get a public template's details. No authentication required.

Get a public object's details. No authentication required.

Search publicly accessible objects. No authentication required.

Get public platform statistics — total objects, templates, and wallets. No authentication required.

List sequencer batches. Batches group multiple transactions for efficient on-chain anchoring via ZK-rollup.

Get details of a sequencer batch including all contained transactions.

List ZK-rollup checkpoints. Each checkpoint contains a state root and proof that anchors batches to L1.

Get a specific ZK-rollup checkpoint with its proof data and state roots.

Upload a file to DUAL storage. Returns a public URL. Useful for template assets, face images, and attachments.

Get a file's URL or content by its storage ID.

Delete a file from DUAL storage.

List all storage assets associated with a template.

Request access to a gated platform feature.

List support messages.

Send a support message to the DUAL team.

List token templates. Templates define the structure, properties, and actions of tokenized objects. Filter by prefix or FQDN.

Create a new token template that defines the structure of tokenized objects. Specify the property schema, allowed actions, and access rules. Example: Create a "Reward Token" template with properties like points, expiry_date, and redeemable status.

Get full details of a template including its property schema, actions, and factory config.

Update a template's name, property schema, or access rules.

Permanently delete a template. This cannot be undone.

List all variations of a template. Variations are alternative configurations of the same template.

Create a variation of an existing template with overridden properties.

Authenticate with email/phone and password. Returns JWT tokens for subsequent API calls. Sets auth automatically for this session.

Create a guest session with limited permissions. No credentials required.