Para Wallet MCP Server

Instructions

Implementation Reference

• src/tools/create-wallet.ts:39-73 (handler)

  The handler function executes the tool logic for create_wallet by calling the Para API.

  export async function handler(client: ParaClient, args: Record<string, unknown>) {
    const body: CreateWalletRequest = {
      type: args.type as CreateWalletRequest['type'],
      userIdentifier: args.userIdentifier as string,
      userIdentifierType: args.userIdentifierType as CreateWalletRequest['userIdentifierType'],
      ...(args.scheme ? { scheme: args.scheme as CreateWalletRequest['scheme'] } : {}),
      ...(args.cosmosPrefix ? { cosmosPrefix: args.cosmosPrefix as string } : {}),
    };
  
    const result = await client.requestWithRetry<CreateWalletResponse>('/v1/wallets', {
      method: 'POST',
      body,
    });
  
    return {
      content: [
        {
          type: 'text' as const,
          text: JSON.stringify(
            {
              ...result,
              _note:
                result.wallet.status === 'creating'
                  ? 'Wallet is being created asynchronously. Use wait_for_wallet_ready to poll until status is "ready" and the address is available.'
                  : undefined,
              _security:
                'This wallet uses MPC — the private key never exists in a single place. Para holds one key share, you hold nothing. Signing requires calling sign_raw which triggers a distributed signing ceremony.',
            },
            null,
            2,
          ),
        },
      ],
    };
  }

• src/tools/create-wallet.ts:8-36 (schema)

  The input schema definition for the create_wallet tool.

  inputSchema: {
    type: 'object' as const,
    properties: {
      type: {
        type: 'string',
        enum: ['EVM', 'SOLANA', 'COSMOS'],
        description: 'Blockchain network type',
      },
      userIdentifier: {
        type: 'string',
        description: 'User identifier (email, phone, or custom ID)',
      },
      userIdentifierType: {
        type: 'string',
        enum: ['EMAIL', 'PHONE', 'CUSTOM_ID', 'GUEST_ID', 'TELEGRAM', 'DISCORD', 'TWITTER'],
        description: 'Type of user identifier',
      },
      scheme: {
        type: 'string',
        enum: ['DKLS', 'CGGMP', 'ED25519'],
        description: 'Signature scheme (defaults based on wallet type: DKLS for EVM, ED25519 for SOLANA)',
      },
      cosmosPrefix: {
        type: 'string',
        description: 'Bech32 prefix for Cosmos wallets (e.g. "cosmos")',
      },
    },
    required: ['type', 'userIdentifier', 'userIdentifierType'],
  },

• src/types.ts:27-34 (schema)

  The TypeScript/Zod schema for the CreateWallet request body.

  export const CreateWalletRequestSchema = z.object({
    type: WalletTypeSchema,
    userIdentifier: z.string().min(1),
    userIdentifierType: UserIdentifierTypeSchema,
    scheme: SignatureSchemeSchema.optional(),
    cosmosPrefix: z.string().optional(),
  });
  export type CreateWalletRequest = z.infer<typeof CreateWalletRequestSchema>;

• src/types.ts:46-50 (schema)

  The TypeScript/Zod schema for the CreateWallet response body.

  export const CreateWalletResponseSchema = z.object({
    wallet: WalletSchema,
    scheme: z.string().optional(),
  });
  export type CreateWalletResponse = z.infer<typeof CreateWalletResponseSchema>;