DUAL MCP Server

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.

Create a new wallet account. A verification code will be sent to the email/phone provided.

Complete registration by submitting the verification code sent to your email/phone.

Exchange a refresh token for a new access token.

Get the authenticated wallet's profile — ID, nickname, email, avatar, language, activation status.

Update the authenticated wallet's nickname, language, or avatar.

Retrieve a wallet's public profile by its ID.

Send a password reset code to the wallet's email/phone.

Submit reset code and set a new password.

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.

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.

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.

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 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.

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.

List all registered webhooks. Filter by type, template, action, or active status.

Register a webhook to receive real-time notifications when events occur on the platform.

Get details of a specific webhook.

Update a webhook's URL or active status.

Delete a webhook subscription.

Send a test payload to a webhook endpoint to verify it's working.

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 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.

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.

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

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

Request access to a gated platform feature.

List support messages.

Send a support message to the DUAL team.

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.