Skip to main content
Set up API access, test the token, and connect a client signer for the operations that need one.

Choose Your Setup

API Token Only

Query wallets, balances and signing requests. Record eligible API-user approvals without a signer. With full access, create requests on existing app-managed wallets and complete signing in the MPCVault App.

API Token + Client Signer

Create API wallets and sign requests automatically. Your callback handler controls approval.

Part 1: Create an API User (Required)

Every API integration starts with creating an API user and obtaining a token.

Step 1: Create the API user

  1. Go to console.mpcvault.com.
  2. Navigate to the API page (org admin required).
  3. Click Create an API user.
Create API User
  1. Fill in the required fields:
  1. Click Create to generate the API user.

Step 2: Save your API token

After creation, a popup displays your API token. Copy and save it immediately.
You cannot retrieve the full API token again. If you lose it, you must generate a new one.

Step 3: Test your token

Verify your token works by making a test request:

Token access mode

Full-access tokens can create, execute and reject requests and update wallets within their configured vault access. Read-only tokens can query accessible data and use ApproveSigningRequest for eligible policy-controlled API-user approvals, without signing or a ClientSigner. They cannot retrieve signature bytes. See Access modes.

What you can do now

Continue with the integration walkthrough and network examples. Application examples and SDKs are available on GitHub.

Part 2: Set Up the Client Signer (Optional)

Skip this section if you only query existing wallets, record API-user approvals, or use manual signing on app-managed wallets.
The client signer is required for API wallet creation and automated signing. It’s a Docker container that runs on your infrastructure and programmatically approves transactions based on your business logic.

Client Signer Setup

Complete guide to setting up the client signer, including key generation, Docker deployment, and callback handler implementation.

Custom EVM Chains

The custom EVM tutorial covers network setup, transaction parameters, signing, application broadcast and confirmation.

Troubleshooting

For client signer troubleshooting, see the Client Signer Setup guide.